若依框架文件上传返回路径端口错误 - Nginx代理环境下serverConfig.getUrl()获取端口异常

一 、问题描述

在使用若依框架进行项目开发时，遇到了一个令人困扰的问题：文件上传功能在本地开发环境运行正常，但部署到服务器后，上传文件返回的访问路径缺少端口号，导致无法正常访问上传的文件。

二、问题现象

本地环境：http://ip:8080/profile/xxx.jpg ✅
Nginx代理后：http://ip/profile/xxx.jpg ❌（缺少端口号）
期望结果：http://ip:8080/profile/xxx.jpg ✅

三、问题根本原因

经过深入分析，发现问题的根本原因是：Nginx代理配置中Host头信息不完整，导致后端获取不到正确的端口信息。

3.1 代码分析

若依框架中的URL生成逻辑：

// 文件上传返回URL生成
String url = serverConfig.getUrl() + fileName;

public String getUrl() {
    HttpServletRequest request = ServletUtils.getRequest();
    return getDomain(request);
}

public static String getDomain(HttpServletRequest request) {
    StringBuffer url = request.getRequestURL();  // 关键：这里获取的URL缺少端口号
    String contextPath = request.getServletContext().getContextPath();
    return url.delete(url.length() - request.getRequestURI().length(), url.length()).append(contextPath).toString();
}

3.2 问题核心

request.getRequestURL() 在Nginx代理环境下获取到的URL信息不包含端口号，因为Nginx传递给后端的Host头信息不完整。

四、解决方案

最佳解决方案：修正Nginx配置
问题配置：

location /prod-api/ {
    proxy_set_header Host $http_host;  # ❌ 缺少端口信息
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header REMOTE-HOST $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_pass http://localhost:8080/;
}

正确配置：

location /prod-api/ {
    proxy_set_header Host $http_host:8080;  # ✅ 明确指定端口号
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header REMOTE-HOST $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_pass http://localhost:8080/;
}

核心差异说明

五、总结

在使用若依框架时，若文件上传后返回的访问路径因Nginx代理丢失端口号（如 http://ip/profile/xxx.jpg应为 http://ip:8080/profile/xxx.jpg），其根本原因是Nginx默认配置未传递完整Host头（proxy_set_header Host $http_host不含端口）。​​解决方案​​只需在Nginx配置中显式添加端口（如 proxy_set_header Host $http_host:8080），确保后端通过 request.getRequestURL()获取完整URL，即可快速修复该问题。

如果您在使用若依框架过程中遇到类似问题或其他技术难题，欢迎在评论区留言反馈。我们建议您反馈时提供以下信息，以便更快定位和解决问题