ThinkPHP请求统计必须主动过滤内部调用，关键依据是$request->isCli()返回true，可准确识别定时任务、队列消费等CLI请求；对HTTP类内部请求（如/healthz、X-Internal-Source头）需结合路径白名单与自定义Header双重校验，避免误统计。
ThinkPHP 请求统计必须主动过滤内部调用，否则定时任务、队列消费、健康检查等请求会污染真实用户流量数据。默认的 Log 或 Trace 机制不区分请求来源，所有 Request 实例都会被记录。
怎么识别内部请求（非 HTTP 入口）
关键不是看 URL，而是看请求启动方式。ThinkPHP 的 Request 对象在 CLI 环境下不会携带 server['HTTP_HOST']、server['REQUEST_URI'] 等字段，且 $request->isCli() 返回 true。
-
$request->isCli()是最可靠判断依据：定时任务（php think timer:run）、队列（php think queue:listen）、命令行调试都走 CLI 模式 - 不要依赖
$request->ip() === '127.0.0.1'：Docker 容器、Nginx 反向代理、K8s Pod IP 都可能暴露为内网地址，误杀率高 - 避免用
$_SERVER['SCRIPT_NAME']判断：CLI 下该值可能是think或空字符串，但 Web 请求也可能被重写为类似路径
中间件里怎么安全跳过统计逻辑
统计逻辑通常放在全局中间件（如 app/middleware/Stat.php）中，需在 handle() 开头就做拦截判断，防止后续业务代码已执行（如 DB 查询、缓存读写）才丢弃。
- 必须先调用
if ($request->isCli()) { return $next($request); }，早于任何统计埋点 - 若统计依赖 Redis 计数（如
Cache::inc('stat:pv')），CLI 请求进来会把 PV 错加成 1，且无法回滚 - 不要在控制器或模型里补判断：中间件已执行完日志、权限、Token 验证，统计污染早已发生
如何过滤来自网关或健康检查的 HTTP 请求
某些内部请求虽走 HTTP，但有明确特征，比如 Kubernetes 的 /healthz、Consul 的 /status/ping、Nginx 的 location /ping，这些需靠路由路径或请求头识别。
立即学习“PHP免费学习笔记（深入）”；
- 在统计中间件中加路径白名单：
in_array($request->path(), ['healthz', 'ping', 'status'], true) - 检查自定义 Header：
$request->header('X-Internal-Source') === 'k8s-probe'，比 UA 更可控 - 避免用
User-Agent过滤：部分探针 UA 可伪造，且有些 SDK（如 Guzzle）默认 UA 和浏览器一样，容易漏判 - 如果用了 API 网关（如 Kong、APISIX），可在网关层加
X-Forwarded-For: 127.0.0.1并在中间件中校验该头 + 路径双重匹配，更稳妥
真正难的不是写几行 if 判断，而是确保所有统计入口（日志、Redis 计数、Prometheus Exporter、自定义埋点）都统一走同一套识别逻辑。漏掉任意一个，数据偏差就会持续放大——尤其当定时任务每分钟跑一次时，一天就多出 1440 条“假 PV”。
