JeecgBoot集成积木报表BI在Nginx代理下的端口问题解析

问题背景

在使用JeecgBoot 3.7.1版本集成积木报表BI时，开发人员遇到了一个典型的环境配置问题：当系统部署到正式环境并通过Nginx代理后，积木报表BI的设计和预览功能无法正常使用，而直接访问后端服务端口则功能正常。

现象描述

具体表现为：

1. 直接访问后端服务端口(如34567)时，积木报表BI的所有功能均正常
2. 通过Nginx代理访问时，基础功能可用，但设计和预览功能失效
3. 浏览器开发者工具显示请求返回404错误

问题分析

通过排查发现，问题的核心在于Nginx代理配置中关于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;
    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";
}

问题出在proxy_set_header Host $host这一行，它只传递了主机名而没有包含端口信息。积木报表BI在设计预览功能时，需要完整的URL信息来构建正确的请求路径。

解决方案

将Nginx配置中的Host头修改为包含端口信息：

proxy_set_header Host $host:$server_port;

这一修改确保了后端服务能够获取到完整的访问地址，包括端口号，从而使积木报表BI能够正确生成设计预览功能所需的URL。

技术原理

在Web应用中，URL的构建通常依赖于HTTP请求中的Host头信息。当应用部署在反向代理后方时，如果没有正确配置代理传递原始请求信息，应用可能会错误地构建URL：

1. 积木报表BI的设计预览功能需要生成包含完整URL的请求
2. 当Host头不包含端口时，应用默认使用80端口(HTTP)或443端口(HTTPS)
3. 这会导致生成的URL与实际访问URL不一致，从而引发404错误

最佳实践建议

对于JeecgBoot集成积木报表BI的Nginx配置，建议采用以下更全面的配置：

location /your-context-path {
    proxy_pass http://backend-server:port/your-context-path;
    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 X-Forwarded-Proto $scheme;
    
    # WebSocket支持
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    
    # 超时设置
    proxy_connect_timeout 60s;
    proxy_read_timeout 600s;
    proxy_send_timeout 600s;
}

总结

JeecgBoot集成积木报表BI时遇到的设计预览功能失效问题，本质上是反向代理配置不完整导致的URL构建错误。通过正确配置Nginx传递Host头信息，特别是包含端口号，可以解决这类问题。这也提醒我们在部署Web应用时，需要特别注意反向代理环境下的请求头传递配置。