FrankenPHP Worker模式下单例易致数据污染，须限定单例为全局只读组件、用协程上下文隔离请求数据、资源类单例需自动重连与WeakMap管理、框架模型层须避免事务状态残留。
FrankenPHP 开启 worker 模式后，PHP 进程常驻内存，所有请求共享同一个进程上下文。这意味着传统的单例（如 static self $instance）一旦初始化，就会贯穿整个 worker 生命周期——后续不同请求反复复用它，极易导致用户数据、数据库连接、缓存状态等相互污染。
明确单例的生命周期边界
worker 模式下没有“每次请求新建一次单例”的天然保障。必须主动划清作用域：
- 不要把请求级数据（如用户 ID、请求参数、临时 token）存进单例属性；
- 单例只用于真正全局、无状态或只读的组件（如配置管理器、日志通道注册器）；
- 若需跨函数传递请求上下文，改用
Coroutine::getContext()（协程环境）或显式传参； - 对 Laravel/Symfony 等框架，禁用自动绑定 Request 到单例的行为（如
App::bind('request', ...)），改用依赖注入或请求对象显式传递。
用协程上下文替代请求级单例
FrankenPHP 的 worker 模式默认启用协程（基于 PHP 8+ 的 Fiber），这是隔离请求数据最轻量、最安全的方式：
- 在入口或中间件中写：
Coroutine::getContext()['user'] = $currentUser; - 业务逻辑中取值：
$user = Coroutine::getContext()['user'] ?? null; - 该数据仅限当前协程可见，协程结束即销毁，完全避免跨请求残留；
- 注意：此方式仅适用于协程回调（如
php { ... }路由内），非协程环境（如 CLI 启动脚本）不生效。
连接/资源类单例必须支持重连与隔离
数据库连接、Redis 客户端、HTTP 客户端等资源型单例，在 worker 常驻下更易因超时、断连、认证失效而卡死：
立即学习“PHP免费学习笔记（深入）”；
- 每次使用前检查连接有效性（如
$pdo->getAttribute(PDO::ATTR_CONNECTION_STATUS)或$redis->ping() === '+PONG'）； - 封装“懒加载 + 自动重连”逻辑：连接失败时销毁旧实例，重建新连接；
- 避免静态数组缓存连接（如
self::$connections[$dsn]），改用WeakMap关联连接对象本身（PHP ≥ 8.0），确保连接关闭后自动清理； - 对 Guzzle 等 HTTP 客户端，启用内置连接池（
handler => Pool::create(...)），而非复用单个 client 实例处理全部请求。
框架模型层避免事务污染
像 Laravel 中的 Eloquent 模型，若在单例里缓存了带未提交事务的状态，会导致后续请求误读脏数据：
- 禁用全局模型缓存（如
Model::cacheFor(...)）或限定缓存 scope 为当前请求； - 在事务开始前清除模型静态状态（
Model::flushQueryCache()）； - 利用
Model::registerGlobalScope()实现事务级作用域隔离，确保find()在同一事务中复用已查实例，跨事务则强制刷新； - 关键业务逻辑中，显式使用
DB::transaction()包裹，并避免在事务外持有模型实例引用。
