JeecgBoot项目中仪表盘API基础路径配置问题解析

问题背景

在JeecgBoot 1.9.1版本中，用户反馈在yml配置文件中设置了jeecg.jmreport.apiBasePath参数，但在仪表盘设计页面中该配置并未生效。项目部署在内网服务器上，通过公网服务器的Nginx进行转发。

配置分析

用户提供的配置如下：

jeecg:
  jmreport:
    apiBasePath: https://www.nbmssoft.com

这个配置的目的是为了设置报表API的基础路径，理论上应该影响仪表盘设计页面中所有API请求的基础URL。

问题现象

从截图可以看出：

1. 仪表盘设计页面中发起的API请求仍然使用了原始的服务器地址，而非配置的https://www.nbmssoft.com
2. 请求路径中包含了/ms-api/ruoyi-admin这样的前缀
3. 请求中携带了有效的JWT token

技术原理

在JeecgBoot项目中，apiBasePath配置应该影响以下方面：

1. 报表设计器生成的API调用地址
2. 仪表盘组件获取数据的请求地址
3. 报表预览和导出的基础URL

当这个配置不生效时，通常有以下几种可能原因：

1. 配置项名称错误或层级不正确
2. 配置未正确加载到Spring环境中
3. 前端代码中硬编码了API路径
4. 存在其他拦截器或过滤器修改了请求URL

解决方案

根据开发者的回复，此问题已在后续版本中修复。对于遇到类似问题的用户，可以尝试以下解决方案：

1. 检查配置加载：确保配置已正确加载到Spring环境中，可以通过@Value注解或Environment对象验证。

2. 版本升级：考虑升级到最新版本的JeecgBoot，该问题已在后续版本中修复。

3. 临时解决方案：如果无法立即升级，可以考虑以下替代方案：

   • 使用Nginx的rewrite规则统一修改API路径
   • 自定义拦截器修改请求URL
   • 在前端代码中全局替换API基础路径

4. 配置验证：确保配置的格式正确，特别是URL不应以斜杠结尾。

最佳实践

对于需要配置API基础路径的场景，建议：

1. 在开发、测试和生产环境使用不同的配置文件
2. 使用环境变量来管理敏感配置
3. 在应用启动时打印关键配置值以便验证
4. 对于前后端分离项目，确保前端也使用相同的配置基础

总结

JeecgBoot项目中仪表盘API基础路径配置问题是一个典型的配置加载问题。通过理解配置加载机制和请求处理流程，可以更好地诊断和解决类似问题。对于1.9.1版本的用户，建议升级到包含修复的版本，或者采用临时解决方案确保系统正常运行。