ThinkPHP 接口透传 trace_id 需在中间件中读取或生成并绑定到 Request，调用下游时手动注入 X-Trace-ID 头；灰度路由需在染色后解析标识并动态改写目标地址；Web Server 需配置透传自定义头，协程下须用上下文存储 trace_id。
ThinkPHP 接口如何透传 trace_id 实现调用链路染色
必须手动注入 trace_id 到下游 HTTP 请求头，ThinkPHP 默认不处理分布式链路追踪字段。核心是让每次请求携带唯一标识，并在日志、RPC、HTTP 调用中持续透传。
- 在中间件（如
AppMiddleware）里从请求头读取X-Trace-ID，若不存在则生成一个（推荐用uniqid('', true)或更稳定的 UUIDv4） - 将该
trace_id绑定到think\Request的属性或容器中（例如app('request')->traceId = $traceId），确保后续逻辑可访问 - 调用外部接口时（比如用
think\Http或cURL），显式添加请求头：['X-Trace-ID' => $traceId]；漏掉这步，链路就断了 - 注意：如果用了 Swoole 或协程模式，
static变量或全局变量无法跨协程隔离，必须用Co::getUid()+ 上下文存储，或依赖Swoole\Coroutine\Channel管理
ThinkPHP 测试流量如何定向到指定后端实例（灰度路由）
不能靠 Nginx 或网关层做，因为测试流量需在应用内识别并干预转发逻辑。关键是拦截请求、解析灰度标识、动态改写目标地址。
- 灰度标识建议从请求头（如
X-Env）、Cookie（gray_env=dev2）或 query 参数（?env=staging）中提取，避免污染业务参数 - 在发起远程调用前（比如封装的
ApiService::call()方法），根据标识查配置表或配置文件，拿到目标实例地址（如http://api-dev2.internal:8080） - 务必校验目标地址合法性，禁止直接拼接用户输入——否则可能触发 SSRF；可用白名单域名 + 端口限制（如只允许
api-*.internal） - 若用
think\Http，注意它默认不支持运行时替换 base_uri；得用new Http(['base_uri' => $target])实例化新客户端，而非复用全局单例
为什么 Request::header() 拿不到自定义头，导致染色失败
常见于 Nginx 或 Apache 配置未透传，或 PHP-FPM 丢弃了带下划线的 Header。这不是 ThinkPHP 的 Bug，而是 Web Server 层面的默认行为。
在SEO发布前，从路由清单生成XML网站地图和robots.txt
下载
当代理已经知道网站路由或内容URL，并且在启动前需要有效的sitemap XML、sitemap索引或robots.txt引用时，请使用sitemap。这是一个发布构件技能，而不是爬虫或SEO平台。
- Nginx 默认会把
X-Trace-ID这类含连字符的头转成HTTP_X_TRACE_ID，但 PHP 不自动还原；需在 Nginx 配置里加underscores_in_headers on;并用fastcgi_param HTTP_X_TRACE_ID $http_x_trace_id; - Apache 下需启用
mod_headers，并在.htaccess或 vhost 中用RequestHeader set X-Trace-ID "%{HTTP:X-Trace-ID}e" - 本地测试用
php -S时，它压根不解析自定义 header，必须换artisan serve或真正 Web Server - 验证方式：打印
$_SERVER数组，搜HTTP_X_前缀，确认值是否存在
测试流量路由和链路染色共存时最易忽略的点
两者叠加后，trace_id 必须随目标实例变化而保持不变——不是每个实例生成一个新 ID，而是同一个请求在整个链路中始终用同一个 ID。
立即学习“PHP免费学习笔记（深入）”；
- 灰度路由逻辑必须在染色中间件之后执行，否则你拿不到已生成的
trace_id，也无法透传给下游 - 如果灰度规则依赖用户身份（如 uid % 100
- 日志输出时，别只打
$request->header('x-trace-id')——要确保这个值是从中间件注入的、非空的、且没被后续逻辑覆盖；建议统一用Log::channel('trace')->info('', ['trace_id' => $tid]) - 协程环境下，
think\Container的单例绑定对不同协程不安全，trace_id必须存在协程上下文里（Co::getContext()或框架封装的Context::get()）
