一 、問題描述

在使用若依框架進行項目開發時，遇到了一個令人困擾的問題：文件上傳功能在本地開發環境運行正常，但部署到服務器后，上傳文件返回的訪問路徑缺少端口號，導致無法正常訪問上傳的文件。

二、問題現象

本地環境：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/;
}

核心差異說明

配置項	效果	后端獲取到的Host
Host $http_host	? 不包含端口	yourdomain.com
Host $http_host:8080	? 包含端口	yourdomain.com: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，即可快速修復該問題。

如果您在使用若依框架過程中遇到類似問題或其他技術難題，歡迎在評論區留言反饋。我們建議您反饋時提供以下信息，以便更快定位和解決問題