Tianji 项目中的 CORS 配置问题解决方案

在部署和使用 Tianji 网站统计服务时，部分用户可能会遇到数据无法正常上报的问题。本文将以 Ghost CMS 为例，详细分析问题原因并提供解决方案。

问题现象

用户在 Ghost CMS 中集成 Tianji 统计代码后，发现虽然浏览器发出了请求（返回 204 状态码），但 Tianji 后台却无法显示任何访问数据。通过浏览器开发者工具检查，可以观察到请求成功发送但数据未被记录的情况。

根本原因分析

经过排查，这类问题通常是由于跨域资源共享（CORS）限制导致的。具体表现为：

1. 浏览器出于安全考虑，默认会阻止跨域请求
2. 当统计代码与 Tianji 服务不在同一域名下时，需要正确配置 CORS 策略
3. 某些反向代理或网关服务（如 Cosmos Server）默认会禁用 CORS 功能

解决方案

方案一：直接配置 Tianji 服务

如果直接访问 Tianji 服务，通常服务端已经内置了 CORS 中间件，理论上应该能正确处理跨域请求。但如果仍然遇到问题，可以检查：

1. 确保 Tianji 服务版本是最新的
2. 验证服务端 CORS 中间件是否正常工作

方案二：网关层配置（推荐）

对于使用 Cosmos Server 等网关服务的用户，需要在网关层明确配置 CORS 策略：

1. 登录网关管理界面
2. 找到 CORS 配置选项
3. 添加 Tianji 服务的域名到允许列表中
4. 确保启用了必要的 HTTP 方法（GET、POST 等）

方案三：客户端调整

如果无法修改服务端配置，也可以考虑在客户端进行调整：

1. 确保统计代码正确加载
2. 检查是否有浏览器插件拦截了请求
3. 验证网站 SSL 证书是否有效（HTTPS 网站）

最佳实践建议

1. 对于生产环境，建议通过网关统一管理 CORS 策略
2. 定期检查 CORS 配置，确保不会过度开放权限
3. 监控统计数据的接收情况，及时发现配置问题
4. 考虑使用子域名方式部署，减少跨域需求

总结

CORS 问题是现代 Web 开发中常见的挑战之一。通过正确理解跨域机制并合理配置，可以确保 Tianji 统计服务在各种 CMS 系统中稳定工作。Ghost CMS 用户遇到的数据不上报问题，通过网关层的 CORS 配置即可有效解决。