需实现ResetInterface的服务包括：EntityManager子类或包装器、自定义SessionStorage、带可变上下文的HttpClient装饰器、缓存PDO/mysqli状态的数据库工具类、缓冲日志处理器；核心要求是reset()方法轻量归零请求副作用，禁止I/O与销毁对象。
不是所有 Symfony 服务都需要实现 ResetInterface，只有那些在请求间**持有可变状态、且该状态不能跨请求复用**的服务才必须重置——否则会在 FrankenPHP 的 worker 模式下出现内存污染、数据错乱或连接泄漏。
哪些 Symfony 服务典型地需要 ResetInterface
FrankenPHP 的 worker 模式让整个 PHP 进程（包括容器）常驻内存，每个请求不再重建服务实例。这意味着：如果某个服务在处理请求 A 时修改了内部属性（比如缓存数组、数据库连接句柄、计数器、临时文件路径），而没在请求 B 前清空，B 就会看到 A 留下的脏状态。
以下几类服务最常踩坑，需显式实现 ResetInterface：
-
Doctrine\ORM\EntityManager：官方已实现，但自定义的EntityManager子类或包装器若缓存了查询结果或实体状态，必须重置 -
Symfony\Component\HttpFoundation\Session\Storage\NativeSessionStorage：session 存储本身由框架管理，但如果你写了继承它的自定义存储类，并在其中缓存了 session ID 映射或加密密钥，就得重置 -
Symfony\Component\HttpClient\HttpClient：虽然默认 client 是无状态的，但如果你通过withOptions()或装饰器注入了可变上下文（如动态 base URI、token 刷新逻辑），就需要手动清理 - 任何封装了
PDO或mysqli实例的自定义数据库工具类：连接对象本身不会自动关闭，若你在类里缓存了 lastInsertId、affectedRows 或 prepared statement 句柄，不重置会导致后续请求读到旧值 - 日志通道中的自定义处理器（如写入内存缓冲区再批量 flush 的
BufferHandler子类）：缓冲区内容必须在每次请求前清空，否则日志混杂
ResetInterface 的最小实现要点
只需实现一个 reset() 方法，目标是把所有“请求生命周期内生成的副作用”归零。不要试图销毁整个对象或重建依赖——worker 模式靠的是轻量重置，不是重建。
立即学习“PHP免费学习笔记（深入）”；
常见错误写法：unset($this->cache); $this->cache = []; —— 这看似清空，但如果 $this->cache 是引用其他服务的数组，可能漏掉深层状态。
推荐做法：
- 只重置明确由本服务管理的字段，比如
$this->requestId、$this->buffer、$this->isProcessed - 避免调用
parent::reset()（除非父类明确声明支持该接口） - 不要在
reset()里做 I/O（如写文件、发 HTTP 请求），它应在毫秒级完成 - 若服务依赖其他可重置服务，应在其构造函数中接收
ResetInterface类型提示，或在reset()中显式调用其reset()
如何快速发现漏掉 ResetInterface 的服务
FrankenPHP 启动时不会报错，问题通常在压测或并发请求后暴露：比如 session 数据串号、数据库返回上个用户的记录、日志时间戳错乱。排查路径很直接：
- 启用
frankenphp的 debug 日志：FRANKENPHP_DEBUG=1 frankenphp php-server，观察是否重复打印同一 service 的初始化日志 - 在疑似服务的构造函数和
reset()中加error_log("MyService: construct/reset called")，看是否只 construct 一次、但 reset 未被调用 - 对关键服务加断点：在 Xdebug 中设置条件断点，触发条件为
$this->someState !== null && $this->someState !== []，确认是否残留 - 检查
bin/console debug:container --types=ResetInterface，列出所有已注册的重置服务，对照你的自定义服务查漏
最容易被忽略的是：第三方 Bundle 提供的服务，它们未必适配 worker 模式。比如某些 JWT 验证器会缓存解析后的 token payload，或 API 限流器在内存里维护计数器——这些都得手动补 ResetInterface，不能指望它们默认兼容。
