JeecgBoot大屏设计器HTTPS访问报错问题分析与解决方案

问题背景

在使用JeecgBoot 3.7.1版本的大屏/BI设计器功能时，部分用户反馈在HTTPS环境下访问设计器页面时出现错误。具体表现为页面加载时出现"Failed to execute 'open' on 'XMLHttpRequest': Invalid URL"的错误提示，并且页面持续转圈无法正常加载。

问题现象分析

通过错误截图和用户反馈，可以观察到以下关键现象：

1. 在HTTPS环境下访问设计器页面时，部分API请求仍尝试使用HTTP协议
2. 系统自动拼接的URL中出现了异常的IP地址和端口号（如"-1"）
3. 前端控制台显示XMLHttpRequest请求失败，原因是URL无效

根本原因

经过深入分析，发现问题的根源在于：

1. 协议不一致：前端页面通过HTTPS加载，但部分后端API请求仍使用HTTP协议，导致混合内容问题
2. URL拼接逻辑：系统自动获取服务器IP和端口时，在某些环境下获取到了无效值（如端口号为-1）
3. 反向代理配置：当使用Nginx等反向代理时，后端服务无法正确识别前端使用的协议（HTTPS）

解决方案

方案一：Nginx反向代理配置

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

server {
    listen 443 ssl;
    server_name your.domain.com;
    
    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;
    
    location / {
        proxy_pass http://backend_server;
        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头部，告知后端服务前端使用的实际协议。

方案二：应用服务器配置

对于直接暴露应用服务器的场景，可以：

1. 确保应用配置中正确设置了服务器地址和端口
2. 检查是否有环境变量覆盖了默认配置
3. 在application.properties/yml中明确指定服务器协议：

server:
  forward-headers-strategy: framework
  tomcat:
    remoteip:
      protocol-header: X-Forwarded-Proto

方案三：前端适配

对于前端代码，可以：

1. 检查所有API请求是否使用相对路径（推荐）
2. 避免硬编码协议和域名
3. 确保环境变量配置正确

最佳实践建议

1. 统一协议：确保整个应用使用统一的协议（全站HTTPS）
2. 反向代理配置：使用Nginx等反向代理时，正确传递协议信息
3. 环境检查：部署前检查网络环境和服务器配置
4. 版本升级：考虑升级到最新版本，该问题在后续版本中已得到优化

总结

JeecgBoot大屏设计器在HTTPS环境下的访问问题主要源于协议识别和URL拼接逻辑。通过合理的反向代理配置或应用服务器调整，可以有效解决此类问题。对于生产环境，建议采用方案一的Nginx配置方式，既能解决问题又能获得更好的性能和安全性。

对于开发者而言，理解HTTP/HTTPS混合内容问题和反向代理的工作原理，有助于快速定位和解决类似的前后端交互问题。JeecgBoot团队也在持续优化这方面的问题，建议用户关注官方更新以获取最佳体验。