JeecgBoot积木BI端口号丢失问题分析与解决方案

问题背景

在使用JeecgBoot 3.7.2大屏版（集成JimuBI 1.9.1）时，开发人员遇到了一个关于API请求URL的特殊问题。具体表现为积木BI组件在新建或设计大屏时，API请求URL会丢失端口号，而积木Report组件却能正常发起请求。

问题现象

1. 积木BI异常表现：当用户点击新建或设计大屏时，系统生成的API请求URL中端口号缺失，导致请求无法正确发送到后端服务。
2. 积木Report正常表现：相同环境下，积木Report组件能够正确生成包含端口号的API请求URL，功能正常。

环境配置

• 前端部署在Nginx服务器上，公网端口10086，内网端口8006，启用了SSL加密
• 后端服务运行在内网端口8007，配置了context-path为/erp
• Nginx配置了反向代理和SSL证书

问题分析

经过深入分析，发现该问题主要源于以下原因：

1. 版本兼容性问题：JimuBI 1.9.1版本在处理带有context-path的后端服务时存在缺陷，无法正确拼接完整的请求URL。
2. 配置冲突：当尝试通过customPrePath配置解决时，系统会生成重复的路径（如/erp/erp），导致新的访问问题。

解决方案

1. 升级组件版本：将积木Report和积木BI组件升级至1.9.3版本，该版本已修复了相关URL拼接问题。
2. 配置优化：升级后无需额外配置customPrePath参数，系统即可自动正确处理带有context-path的后端服务。

技术建议

对于使用JeecgBoot框架的开发人员，建议：

1. 保持组件版本更新，及时获取官方修复的bug和改进功能
2. 在配置反向代理和context-path时，注意测试各功能模块的兼容性
3. 对于生产环境，建议先在小规模测试环境中验证新版本的稳定性

总结

JeecgBoot作为一款优秀的企业级开发框架，其组件生态不断完善。通过及时更新组件版本，可以有效解决开发过程中遇到的各种兼容性问题。本次积木BI端口号丢失问题就是通过版本升级得到了完美解决，体现了开源社区持续改进的价值。