Mezzio项目需精确配置依赖、容器与自动加载才能运行，仅composer require mezzio/mezzio不注册组件；路由失效因未安装mezzio/mezzio-router，中间件不执行因autoload未覆盖路径或ServiceManager配置错误，CI失败常因dev包锁版本或PHP平台不匹配。
Mezzio 项目不是“用 Composer 装个框架就跑起来”，而是靠 Composer 精确控制依赖拓扑、隔离 PSR-11 容器策略、并配合手动配置才能稳定承载企业级 API 流量。装错一个包、配错一行 shared、漏掉一个 autoload 映射，都会导致中间件不执行、服务拿不到、甚至 PHP fatal error 直接 500。
composer require mezzio/mezzio 后为什么路由不生效？
Mezzio v4 不再自动注册任何组件；composer require mezzio/mezzio 只装代码，不建管道。必须显式引入路由器和处理器：
-
mezzio/mezzio-router（如mezzio/mezzio-fastroute）是必需的，否则config/pipeline.php里调用$app->route()会报Call to undefined method -
mezzio/mezzio-handler必须存在，否则PsrHttpServerRequestHandlerInterface实现类无法被识别为合法处理器 - 若用了
mezzio/mezzio-laminasrouter，得确认它兼容当前laminas-servicemanager版本（v3.20+ 才支持 PHP 8.2） - 所有中间件类必须能被 autoloader 找到：检查
"autoload": {"psr-4": {"App\": "src/"}}是否覆盖了你的中间件路径，比如src/Middleware/AuthMiddleware.php对应命名空间AppMiddleware
ServiceManager 配置错在哪？get() 报 ServiceNotFoundException
不是没注册服务，而是注册方式与 Mezzio 生命周期不匹配。Mezzio 默认用 PHP-DI，换 SM 必须切断默认链路：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
config/container.php必须返回new LaminasServiceManagerServiceManager($config)，不能只 return $container；且$config中的factories键必须是顶层键，不能嵌套在dependencies下 - 工厂类必须实现
FactoryInterface或是可调用对象，不能只写return new MyService();—— ServiceManager 不会自动解析构造参数，除非你用 delegator 或提前 setService - 共享策略默认开启：同一服务多次
get()返回同一个实例；若需每次新建（如带状态的 Validator），必须在 config 中设'shared' => false - 别把
ServiceManager实例塞进$app；Mezzio 的$app是Application实例，它不持有容器，容器由ContainerInterface提供，由ConfigProvider注入
composer install --no-dev 在 CI/CD 中为何仍失败？
因为 require-dev 里的包虽不进生产，却参与依赖求解——它们可能悄悄锁死主依赖版本上限：
- 运行
composer update --no-dev --dry-run，看是否跳过冲突；如果成功，说明 dev 包是罪魁祸首（常见如phpunit/phpunit强绑symfony/console:^5，而你主项目要 ^6） - 删掉
require-dev后，必须立刻composer update --no-dev并提交新composer.lock；否则 CI 仍按旧 lock 解析，失败照旧 - CI 环境中务必检查
php -v与composer show --platform输出是否一致；lock 文件锁了 PHP 8.2，但 runner 是 8.0，Fatal error: Uncaught TypeError就在所难免 -
--optimize-autoloader和--classmap-authoritative必须配套使用：后者要求所有类都在 classmap 中，否则Class not found不报错、不提示，只静默失败
MezzioTooling 生成的 Handler 为什么注入失败？
Tooling 只管文件结构和命名空间，不管依赖绑定逻辑。工厂类写对了，但 ServiceManager 没加载它：
- 生成的
MyHandlerFactory必须在ConfigProvider::getDependencies()返回的数组里注册，例如：'factories' => ['AppHandlerMyHandler' => AppHandlerMyHandlerFactory::class] - 工厂类的
__invoke()方法必须返回对象实例，不能只 new 出来就 return；如果依赖其他服务，得从$container中 get，例如：return new MyHandler($container->get(LoggerInterface::class)); - 若 Handler 构造函数参数类型是接口（如
LoggerInterface），确保该接口已在容器中注册为服务名，或通过delegators映射到具体实现 - 别信 Tooling 自动生成的
ConfigProvider—— 它常漏掉getDependencies()，只写了getServices()，而 Mezzio v4 要求前者
最常被忽略的是：Mezzio 的容器初始化发生在 config/container.php，而路由/中间件注册发生在 config/pipeline.php，两者加载时机不同；中间件里 $container->get() 拿不到服务，往往是因为容器还没 fully built，或者服务注册顺序错了——这不是代码问题，是 Composer + 配置 + 加载时序共同作用的结果。
