Leantime项目仪表盘通知加载异常问题分析

问题现象

在Leantime项目管理系统中，当用户通过IP地址和端口直接访问时，仪表盘首页(/dashboard/home)的通知功能可以正常加载。然而，当通过Nginx反向代理配置的域名(如https://leantime.domain.com)访问时，仪表盘首页的通知区域会出现持续加载状态，无法正常显示内容。

技术分析

经过深入排查，发现问题主要出现在两个关键接口调用上：

1. /widgets/welcome/get接口
2. /widgets/welcome/todos接口

这两个接口在通过域名访问时，仍然尝试从原始的IP:PORT地址获取数据，而不是使用配置的域名地址。这与系统中其他正常工作的接口形成鲜明对比。

根本原因

通过对代码的分析，发现widgets模块中的服务文件(widgets.php)虽然正确地使用了BASEURL常量来构建请求URL（如BASEURL."/widgets/welcome/get"），但在某些情况下，BASEURL的值没有被正确更新为域名地址，而是保留了原始的IP:PORT地址。

这种不一致性通常发生在以下情况：

1. 系统配置未完全更新：当从IP:PORT迁移到域名访问时，某些缓存或配置文件可能未被正确更新
2. 反向代理配置问题：Nginx的代理设置可能未正确处理某些请求头，导致后端获取的BASEURL不正确
3. 会话数据残留：用户会话中可能保留了旧的URL信息

解决方案

对于遇到此问题的用户，可以尝试以下解决方法：

1. 重置仪表盘设置：在仪表盘设置中选择"重置仪表盘"选项，这可以清除可能导致问题的旧配置

2. 检查配置文件：

   • 确保config.php文件中的BASEURL已更新为域名地址
   • 检查SESSION配置是否正确

3. Nginx配置调整：

   • 确保proxy_set_header正确设置了Host和其他相关头信息
   • 检查是否有重定向规则影响了API请求

4. 清除缓存：

   • 清除浏览器缓存
   • 清除服务器端缓存（如OPcache）

预防措施

为避免类似问题，建议：

1. 在切换访问方式前，先更新所有相关配置
2. 使用配置管理工具确保环境一致性
3. 实现自动化的配置验证机制
4. 在代码中使用相对路径而非绝对路径，减少对BASEURL的依赖

通过以上分析和解决方案，用户应该能够解决Leantime系统中仪表盘通知加载异常的问题，确保系统在不同访问方式下都能正常工作。