Spring MVC容器化项目移除URL端口后静态资源加载异常排查

核心原因 #

1. 资源处理器优先级冲突：自定义资源处理器注册顺序错误，先注册的/**会匹配所有请求（包括/uploads/**），导致挂载卷对应的/uploads/**处理器被覆盖，无法访问挂载卷中的文件。
2. 静态资源路径适配问题：硬编码的绝对资源路径在HTTPS/反向代理环境下存在解析偏差，同时静态资源的实际部署位置可能存在遗漏。
3. Docker端口映射不匹配：初始部署仅映射主机8088端口到容器443，直接访问主机443时请求未转发到目标容器。

解决步骤 #

1. 调整资源处理器注册顺序 #

将更具体的路径处理器放在前面，确保/uploads/**请求优先被挂载卷处理器处理：

@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
    // 先注册/uploads/**，优先级高于通用规则
    registry
            .addResourceHandler("/uploads/**")
            .addResourceLocations("file:/var/photos/");
    // 再注册通用静态资源规则
    registry
            .addResourceHandler("/**")
            .addResourceLocations("classpath:/static/");
}

2. 验证静态资源部署位置 #

进入容器检查script.js是否存在于正确的静态资源目录：

docker exec -it project-admin-container ls /app/BOOT-INF/classes/static/

（路径根据容器内Spring Boot应用的实际位置调整，确保script.js在该目录下）

3. 修复资源路径硬编码问题 #

避免硬编码上下文路径，改用框架动态生成路径：

• JSP环境：

  <script src="${pageContext.request.contextPath}/script.js"></script>
  

• Thymeleaf环境：

  <script th:src="@{/script.js}"></script>
  

4. 配置反向代理与路径解析（若使用Nginx等代理） #

如果主机443端口通过反向代理转发到容器，需在代理配置中正确传递请求头，并确保路径转发完整：

server {
    listen 443 ssl;
    server_name ssh.host;

    ssl_certificate /path/to/your/cert.pem;
    ssl_certificate_key /path/to/your/key.pem;

    location /project/ {
        proxy_pass https://localhost:443/project/;
        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;
    }
}

同时在Spring配置中开启转发头支持：

server:
  servlet:
    context-path: /project
  forward-headers-strategy: FRAMEWORK

5. 修正Docker端口映射 #

若直接通过主机443访问容器，修改docker run命令映射主机443到容器443：

docker run -d --name project-admin-container -p 443:443 --network someNetwork -v someVolume:/var/photos dockerHubAcc/project-admin

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