生产环境Spring Boot应用文件访问URL前缀显示localhost而非真实域名

基于Spring Boot MVC与Thymeleaf开发的Web应用，本地运行时所有功能正常，但部署到Linux服务器的Tomcat 9.0.71生产环境后，点击文件查看（Fayla bax）或下载（Faylı yüklə）按钮时，生成的URL前缀为http://localhost:8080/files/c9376e46-55cb-4cf5-beab-ba886bb23c5f/bb/view/这类，而非预期的真实域名example.az/xxx。

核心原因 #

问题出在FileBBController的getOnePage方法中，使用ServletUriComponentsBuilder.fromCurrentContextPath()生成文件URL时，该方法依赖Tomcat内部的请求上下文信息。当Tomcat运行在反向代理后，或未正确配置外部访问地址时，会获取到Tomcat内部的localhost:8080，而非真实域名。

解决方案 #

方案1：修正Tomcat连接器配置 #

修改Tomcat的conf/server.xml中的Connector节点，添加外部访问的域名、端口和协议配置：

<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443"
           proxyName="example.az"
           proxyPort="80" <!-- HTTPS环境改为443 -->
           scheme="http" <!-- HTTPS环境改为https -->
           />

配置后，ServletUriComponentsBuilder会自动使用真实域名生成URL。

方案2：手动指定基础URL（多环境适配） #

通过配置文件指定真实域名，避免依赖Tomcat上下文：

1. 在application.properties中添加配置：

app.base-url=https://example.az

2. 修改FileBBController的URL生成逻辑：

@Value("${app.base-url}")
private String baseUrl;

// 在getOnePage方法中替换原URL生成代码
String fileDownloadUri = UriComponentsBuilder.fromHttpUrl(baseUrl)
        .path("/files/")
        .path(dbFile.getId())
        .toUriString();

方案3：适配反向代理场景（如Nginx） #

若应用通过Nginx反向代理到Tomcat，需在Nginx配置中传递真实请求头，同时让Tomcat信任这些头：

1. Nginx配置示例：

location / {
    proxy_pass http://localhost:8080;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

2. 修改Tomcat的conf/server.xml，在Engine节点下添加Valve：

<Engine name="Catalina" defaultHost="localhost">
    <Valve className="org.apache.catalina.valves.RemoteIpValve"
           remoteIpHeader="X-Forwarded-For"
           protocolHeader="X-Forwarded-Proto"
           protocolHeaderHttpsValue="https"/>
    <!-- 其他原有配置 -->
</Engine>

额外优化：Thymeleaf URL拼接规范 #

修正files.html中的URL拼接方式，使用Thymeleaf原生语法避免字符串拼接错误：

<!-- 文件查看按钮 -->
<td class="text-center">
    <a target="_blank" th:href="@{${file.url}/bb/view}">
        <i class="fa fa-thin fa-eye fa-lg"></i>
    </a>
</td>

<!-- 文件删除按钮 -->
<td sec:authorize="hasRole('ADMIN')" class="text-center">
    <a th:href="@{${file.url}/bb/delete}" th:fileName="${file.name}" style="border: none; background: none"
       id="btnDelete" class="btn-delete" data-bs-toggle="modal" data-bs-target="#exampleModal">
        <i class="fa-solid fa-trash fa-xl" style="color: red"></i>
    </a>
</td>

内容的提问来源于stack exchange，提问作者Elkhan Ismayilov