Jeecg-Boot大屏设计器HTTPS访问问题解析与解决方案

在使用Jeecg-Boot 3.7.1版本的大屏/BI设计器功能时，部分用户遇到了一个典型的HTTPS环境下访问异常的问题。当通过HTTPS协议访问设计器页面时，控制台会报错"Failed to execute 'open' on 'XMLHttpRequest': Invalid URL"，同时页面持续处于加载状态。

问题现象分析

该问题的核心表现是：

1. 通过HTTPS访问/drag/index设计器页面时出现异常
2. 浏览器控制台显示XMLHttpRequest请求失败
3. 深入排查发现请求URL中出现了非预期的"-1"端口号
4. 系统错误地将HTTP协议与HTTPS环境混合使用

根本原因

经过技术分析，问题的根源在于：

1. 设计器功能在获取服务地址时，错误地获取了服务器本机IP而非公网域名
2. 协议处理不当，在HTTPS环境下仍然生成了HTTP协议的请求
3. 端口号处理异常，出现了无效的"-1"端口值
4. 未正确处理反向代理场景下的协议转换

解决方案

针对这一问题，我们推荐以下几种解决方案：

方案一：Nginx反向代理配置

对于使用Nginx作为反向代理的场景，可以通过添加以下配置解决：

server {
    listen 443 ssl;
    server_name your.domain.com;
    
    # SSL证书配置
    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;
    
    location / {
        proxy_pass http://localhost:8080;
        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 X-Forwarded-Proto $scheme;  # 关键配置
    }
}

其中X-Forwarded-Proto头部是关键，它告知后端服务器实际使用的协议是HTTPS。

方案二：应用服务器配置

在应用服务器层面，可以配置以下参数：

1. 确保server.servlet.context-path正确设置
2. 检查jeecg.domain.white白名单配置
3. 验证jeecg.safe.domain安全域名设置

方案三：升级到最新版本

Jeecg-Boot开发团队已在新版本中修复了此问题，建议用户升级到最新稳定版。新版本改进了：

1. URL生成逻辑
2. 协议处理机制
3. 端口号获取方式

最佳实践建议

1. 生产环境务必使用标准端口（HTTPS为443）
2. 确保反向代理配置完整，特别是协议相关头部
3. 定期更新到官方推荐版本
4. 测试环境与生产环境保持一致的协议配置
5. 监控系统日志，及时发现类似协议不匹配的问题

通过以上解决方案，用户可以彻底解决Jeecg-Boot大屏设计器在HTTPS环境下的访问异常问题，确保设计器功能的正常使用。