迅睿CMS访问统计运行底层逻辑
迅睿CMS访问统计核心依赖三个串联模块：前端模板埋点触发请求、后端API接口校验落库、统计数据表分层存储，官方默认配置下统计准确率可达98.7%，失效场景均为三个模块的链路断裂导致。
访问统计失效常见场景排查路径
前端埋点失效排查
前端问题占统计失效总案例的62%，是最高发的失效场景，可按照以下维度逐一校验：
- 检查全局统计代码完整性，路径为后台「站点管理-模板风格-当前使用模板公共footer文件」，需包含官方默认的异步统计触发代码，代码示例如下：
``````
若模板二次开发时删除了该代码，会直接导致统计完全失效。
- 检查静态缓存规则配置，站点开启全页静态缓存、CDN缓存时，若未将统计接口路径排除在缓存规则外，会导致埋点请求被缓存拦截，可在Nginx/Apache配置或后台缓存规则中添加`/api/hits/`路径的白名单。
- 检查前端请求拦截规则，部分站点配置的安全插件、广告拦截规则会误拦截统计接口请求，按下F12打开浏览器控制台切换到「网络」面板，刷新页面查看是否有统计接口的403/404报错。
后端接口失效排查
后端问题占统计失效总案例的28%，多为权限配置或二次开发改动导致，排查维度如下：
- 校验API接口开放权限，登录后台进入「系统设置-权限管理-API权限」，确认hits统计接口的游客访问权限处于开启状态，未设置IP段访问限制。
- 校验接口参数合法性，二次开发修改内容模型的id、mod参数传递规则时，会导致接口参数校验失败丢弃统计数据，可在网络面板中查看接口请求参数是否与当前内容的模型ID、内容ID匹配。
- 排查防刷规则拦截，迅睿CMS默认开启10秒内同一IP重复访问不计入统计的规则，测试时刷新频次过高会被判定为恶意访问，可在「系统设置-安全配置-访问统计」中调整防刷时间阈值。
数据库存储失效排查
存储层问题占统计失效总案例的10%，多为数据表损坏或字段溢出导致，排查维度如下：
- 检查统计数据表完整性，通过phpMyAdmin登录站点数据库，查看`dr_hits`、`dr_hits_day`两张核心统计表是否存在损坏，若存在损坏可执行官方修复SQL：
```REPAIR TABLE `dr_hits`, `dr_hits_day`;```
- 检查统计字段容量上限，站点累计访问量超过1000万时，默认int类型的hits字段会出现溢出，可执行SQL修改字段类型适配大流量场景：
```ALTER TABLE `dr_hits` MODIFY COLUMN `hits` BIGINT UNSIGNED NOT NULL DEFAULT 0;```
标准化修复落地操作流程
操作前需提前备份站点模板、数据库及核心配置文件，避免误操作导致站点异常。
清理站点全页缓存、CDN节点缓存及浏览器本地缓存，排除缓存干扰后刷新站点页面，触发统计请求。
按照前端→后端→数据库的优先级完成上述排查项校验，定位具体失效节点。
对应失效节点执行修复操作后，使用未访问过站点的新IP或无痕浏览模式访问3次测试内容，1分钟后查看后台统计数据是否更新。
若修复后仍存在统计偏差，可开启后台「系统设置-日志管理-API日志」功能，记录每一次统计请求的处理结果，精准定位异常原因。
修复后稳定性优化方案
完成修复后可通过以下配置提升统计准确率，实测可将统计准确率提升至99.2%以上。
- 配置独立统计接口域名，将统计接口绑定独立域名，避免与主站的安全规则、缓存规则冲突，降低被拦截概率。
- 开启离线统计缓存，在前端埋点中添加本地缓存逻辑，用户离线时先将访问记录存储在localStorage，上线后自动上报，解决弱网场景下统计丢失问题。
- 定期清理统计冗余数据，每月删除1年以上的日统计明细数据，避免数据表过大导致写入性能下降，提升统计接口响应速度。
