积木报表JimuReport二级域名部署静态资源404问题解决方案

在部署积木报表JimuReport时，当项目需要配置为二级域名（如原域名/demo）访问时，可能会遇到静态资源404的问题。本文将深入分析问题原因并提供完整的解决方案。

问题现象分析

当将项目部署在二级域名下时，积木报表的静态资源请求路径仍然指向原域名路径，导致资源加载失败。从问题描述中可以看到，浏览器控制台会显示类似以下的404错误：

GET http://原域名/jmreport/desreport_/js/chunk-2d0afc8a.4e1d8a0a.js net::ERR_ABORTED 404

根本原因

这个问题主要由两个因素导致：

1. 静态资源路径配置问题：积木报表默认生成的静态资源路径没有考虑二级域名的上下文路径
2. Nginx代理配置问题：反向代理配置没有正确处理路径重写

解决方案

方案一：通过配置文件修改静态资源路径

在积木报表的配置文件中，可以通过customPrePath参数来指定二级域名的前缀路径：

customPrePath: /demo

这个配置会在所有积木报表的路径前添加指定的前缀。例如，原本的/jmreport路径会变为/demo/jmreport。

方案二：Nginx代理配置优化

如果使用Nginx作为反向代理，需要特别注意以下几点配置：

1. 确保代理路径配置正确，避免多余的斜杠
2. 配置路径重写规则，正确处理二级域名的转发

示例Nginx配置片段：

location /demo {
    proxy_pass http://backend-server;
    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_pass指令后的URL不应包含结尾的斜杠，否则会导致路径处理异常。

方案三：使用context-path配置（独立部署时）

如果积木报表是独立部署的服务，可以通过Spring Boot的server.servlet.context-path属性来设置上下文路径：

server.servlet.context-path=/demo

这种方式会为整个应用添加前缀路径，包括所有静态资源和API接口。

最佳实践建议

1. 测试环境验证：在修改配置前，先在测试环境验证配置效果
2. 浏览器缓存清理：修改配置后，清理浏览器缓存避免旧路径缓存影响
3. 监控日志：部署后检查应用和Nginx的访问日志，确认路径处理正确
4. 渐进式部署：对于生产环境，建议采用蓝绿部署等方式逐步验证

常见问题排查

如果按照上述方案配置后仍然出现问题，可以检查以下方面：

1. 确认所有服务都已重启生效新配置
2. 检查浏览器开发者工具中的"Network"选项卡，观察实际请求的URL
3. 查看后端服务日志，确认收到的请求路径是否符合预期
4. 检查是否有CDN或缓存服务器可能缓存了旧路径

通过以上方法和步骤，应该能够解决积木报表在二级域名部署时的静态资源404问题。如果仍有疑问，可以参考积木报表的官方文档或社区讨论获取更多帮助。