JeecgBoot集成积木报表BI的Nginx代理配置问题解析

问题背景

在使用JeecgBoot 3.7.1版本集成积木报表BI时，开发环境运行正常，但在正式环境部署后，积木BI的设计和预览功能出现异常。具体表现为通过Nginx代理访问时，仪表板和大屏的设计预览功能无法正常工作，而直接访问后端服务则一切正常。

问题现象

1. 直接访问后端服务(34567端口)时，积木BI功能完全正常
2. 通过Nginx代理访问时，积木报表功能正常，但积木BI的设计和预览功能失效
3. 浏览器开发者工具显示接口请求失败

根本原因分析

经过排查发现，问题出在Nginx的代理配置上。原始配置中使用了proxy_set_header Host $host，这会导致后端服务接收到的Host头不包含端口信息。积木BI的部分功能依赖于完整的Host信息(包括端口号)来构建正确的URL。

解决方案

修改Nginx配置，将proxy_set_header Host $host替换为proxy_set_header Host $host:$server_port，确保后端服务能够获取完整的Host信息(包含端口号)。

完整配置示例：

location /dentao-api {
    proxy_pass http://127.0.0.1:34567/dentao-api;
    proxy_redirect off;
    proxy_set_header X-Forwarded-Scheme $scheme;
    proxy_set_header Host $host:$server_port;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
}

技术原理

1. Host头的重要性：HTTP协议中，Host头用于标识请求的目标主机和端口，对于构建绝对URL至关重要
2. Nginx代理行为：默认情况下，Nginx转发请求时会重写Host头，可能导致后端服务获取不到原始请求的完整信息
3. 积木BI的特殊性：积木BI的设计和预览功能需要构建包含完整URL(含端口)的请求，因此对Host头信息敏感

最佳实践建议

1. 在Nginx代理配置中，始终传递完整的Host信息
2. 对于需要构建URL的后端应用，建议同时处理以下头部信息：
   • Host
   • X-Forwarded-Host
   • X-Forwarded-Proto
   • X-Forwarded-Port
3. 测试环境应尽可能模拟生产环境的代理配置，避免部署时出现意外

总结

JeecgBoot集成积木报表BI时，Nginx代理配置需要特别注意Host头的传递。通过确保完整的Host信息(包含端口号)被传递到后端服务，可以解决积木BI设计和预览功能失效的问题。这一经验也适用于其他需要构建完整URL的后端应用场景。