RuoYi部署后，访问上传文件报404，如何正确配置静态资源路径？

Question

**问题：RuoYi部署后访问上传文件报404，如何正确配置静态资源路径？** 在RuoYi项目部署完成后，如果访问上传的文件（如图片、文档等）出现404错误，通常是由于静态资源路径配置不当导致。默认情况下，RuoYi将上传的文件存储在服务器的特定目录中，但前端访问时需要正确的映射路径。 解决方法如下： 1. 确认`ruoyi-profile`模块中的`profile.config`是否正确配置了文件上传的基础路径（`uploadPath`）。 2. 检查Nginx或Tomcat是否正确映射了静态资源路径。例如，在Nginx中添加location配置： ```nginx location /profile { alias /你的上传文件目录/; } ``` 3. 如果使用内置Tomcat，确保`application.yml`中`spring.resources.static-locations`包含上传路径。 4. 清理缓存并重启服务，验证配置是否生效。 通过以上步骤，可以有效解决RuoYi部署后访问上传文件报404的问题。

Answer 1

1. 问题概述

在RuoYi项目部署完成后，访问上传文件时出现404错误，通常是因为静态资源路径配置不正确。RuoYi默认将上传的文件存储在服务器的特定目录中，但前端访问这些文件需要正确的映射路径。

• 常见现象： 访问图片、文档等文件时，浏览器返回404错误。
• 可能原因： 静态资源路径未正确映射到实际文件存储位置。

2. 配置检查与调整

以下是逐步解决该问题的方法：

1. 确认上传路径配置： 检查`ruoyi-profile`模块中的`profile.config`文件，确保`uploadPath`已正确设置为服务器上的文件存储目录。
2. 检查Nginx或Tomcat配置： 如果使用Nginx作为反向代理，需添加如下配置：

location /profile {
    alias /你的上传文件目录/;
}

如果使用内置Tomcat，则需要在`application.yml`中添加以下配置：

spring:
  resources:
    static-locations: ["file:/你的上传文件目录/"]

3. 验证与优化

完成上述配置后，还需要执行以下步骤：

• 清理缓存： 清理浏览器缓存以及服务器端缓存，确保加载的是最新配置。
• 重启服务： 重启RuoYi服务以及Nginx或Tomcat服务，使配置生效。

通过访问一个已知的上传文件URL（例如：`http://yourdomain/profile/avatar.jpg`），验证是否能够正常访问文件。

4. 技术分析与扩展

为了更深入地理解问题根源，可以从以下几个方面进行分析：

角度	分析内容
文件存储位置	RuoYi默认将文件存储在`/opt/upload`或其他指定路径下，确保该路径存在且具有读写权限。
路径映射	Nginx或Tomcat需要将`/profile`路径映射到实际文件存储目录，否则会导致404错误。
缓存影响	浏览器或CDN缓存可能导致新配置未及时生效，需手动清除缓存。

5. 流程图示例

以下是解决问题的整体流程图：