接口调用上下文隔离必须绑定到 request 实例的 attributes 属性，而非 static 或 define()；因 worker 进程复用会导致 tenant_id 等标识跨请求污染，而 $request->attributes 随请求新建、天然隔离。
接口调用上下文传递在 ThinkPHP 中不是靠“全局变量”或“静态属性”实现的，而是必须绑定到当前请求生命周期内唯一、可追踪的 Request 实例上。否则在 Swoole 长连接、协程或 FPM 复用 Worker 场景下，tenant_id、trace_id、user_token 等关键标识极易跨请求污染。
为什么不能用 static 或 define() 存租户 ID
ThinkPHP 的 Worker 进程可能处理多个 HTTP 请求，static $tenantId 或 defined('TENANT_ID') 会残留上一个请求的值，导致 DB 查询、缓存 key、日志打点全部错乱。错误现象包括：Db::table('orders')->select() 查出其他租户订单、Redis 缓存命中错误 key、链路追踪 ID 在日志里反复复用。
- 中间件中写
self::$tenantId = $payload['tenant_id']→ 后续请求直接读到旧值 - 用
$_SERVER['TENANT_ID']注入 → CLI 或 Swoole 环境下不可靠，且非线程安全 - 依赖
Auth::id()当租户 ID → 它返回的是用户 ID，和租户无关，除非你手动重写了 Auth 驱动
正确做法：把标识写进 $request->attributes
$request->attributes 是 Symfony HttpFoundation 兼容层提供的标准容器，ThinkPHP 6/8 均沿用。它随每次请求新建，生命周期与 Request 绑定，天然隔离。
- 在鉴权中间件末尾写：
$request->attributes->set('tenant_id', $payload['tenant_id']) - 在控制器里取：
$tenantId = $this->request->attributes->get('tenant_id') - 模型全局作用域中取：
public function apply(Builder $builder, Model $model) { $tenantId = request()->attributes->get('tenant_id'); $builder->where('tenant_id', $tenantId); } - 注意不要用
request()->param('tenant_id')—— 这是业务参数，不是上下文标识，容易被伪造或遗漏
Db::connect() 动态切换时怎么带上下文
即使 tenant_id 已写入 $request->attributes，Db::connect('mysql_tenant_123') 仍可能复用旧连接，因为 ThinkPHP 默认启用连接池缓存，键只认连接名字符串，不感知请求上下文。
- 必须在中间件（或初始化钩子）中调用
Db::setConfig($config, 'mysql_tenant_' . $tenantId)，确保配置实时生效 - 连接名要含租户标识，例如
'mysql_tenant_' . $tenantId，避免不同租户共用同一连接名 - 显式指定连接：
Db::connect('mysql_tenant_123')->table('users')->select()，不能依赖默认连接 - 关闭部署模式复用：
'deploy' => 0，防止生产环境因部署配置误启连接共享
跨服务调用时 trace_id 怎么透传
HTTP 接口调用下游服务（如调 /api/user/profile），trace_id 必须从当前请求头透传出去，否则链路断裂。ThinkPHP 不自动做这件事。
- 从请求头读：
$traceId = $this->request->header('x-trace-id', uniqid('tp-', true)) - 发请求时写入：
Http::withHeaders(['x-trace-id' => $traceId])->post($url, $data) - 如果用 Guzzle，确保
headers数组里显式传了x-trace-id，别依赖中间件自动注入（它只对进站请求有效） - 注意 Swoole 环境下，
curl或file_get_contents不会自动携带 header，必须手写
最易忽略的一点：所有基于 request() 的调用，都必须发生在请求生命周期内。命令行任务、定时器回调、Swoole onReceive 里直接调 request()->attributes->get('tenant_id') 会返回 null —— 因为那里根本没有 Request 实例。这种场景得靠参数显式传递，或者用 Container 作用域配合闭包绑定来模拟上下文。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
