php bin/console lint:container 检查容器配置合法性，包括yaml/php语法、服务类是否存在、参数是否定义、构造函数依赖是否可解析，但不执行完整启动流程。

symfony lint:container 会检查哪些配置

symfony lint:container 实际上并不存在 —— Symfony 官方命令中没有这个命令。你很可能混淆了 php bin/console lint:container（Symfony 内置命令）和 symfony CLI 工具的命令（如 symfony console lint:container，但该命令也不存在）。真正可用的是：

• php bin/console lint:container：检查容器编译前的配置合法性（比如 YAML/PHP 配置语法、服务定义是否引用了不存在的类或参数）
• php bin/console lint:yaml 或 php bin/console lint:xml：分别检查配置文件格式
• symfony console lint:container 是无效命令，symfony CLI 不提供容器校验功能

php bin/console lint:container 的真实作用范围

它不是“静态扫描”，而是尝试构建一个最小化容器实例，触发服务定义解析。这意味着：

• 会加载 config/services.yaml、config/packages/*.yaml 等所有启用的配置
• 检查 class 是否可自动加载（类名拼写错误、命名空间错、未安装依赖都会报错）
• 验证 arguments、calls、bind 中引用的参数或服务是否存在
• 不执行 kernel.boot 事件，也不加载环境特定的完整容器（比如不会因 %env(APP_ENV)% 解析失败而中断）
• 对 bind 和 autoconfigure 的检查较弱，有些问题要等真正运行 cache:warmup 才暴露

常见报错及对应修复方式

运行 php bin/console lint:container 后典型错误包括：

Symfony Linux版

Symfony Linux版整理 Symfony CLI 5.17.1 官方下载入口和 Symfony 框架安装配置说明。

下载

• The service "App\Service\Foo" has a dependency on a non-existent service "App\Repository\BarRepository" → 检查 BarRepository 类是否存在、是否被正确声明为服务（或是否开启 App\Repository\ 自动注册）
• Invalid argument 1 for "App\Service\Foo::__construct()": class "App\Dto\MissingDto" does not exist → 类路径错、文件没创建、或 use 语句漏写
• Parameter "app.some_value" must be defined → 在 services.yaml 中用了 %app.some_value%，但未在 parameters.yaml 或环境变量中定义
• 空输出或只显示 Container linter succeeded. → 并不代表完全安全，只是通过了基础解析；仍可能在缓存生成阶段失败

比 lint:container 更早发现问题的方法

靠 lint:container 发现问题已经偏晚。更推荐前置检查：

• 用 php bin/console debug:container --no-ansi | head -20 快速确认容器是否能初步构建
• 在 IDE 中开启 Symfony 插件（如 PHPStorm 的 Symfony Support），实时标红未定义的服务或参数
• 把 services.yaml 中的 class: 值粘贴到编辑器里，看能否跳转到对应类 —— 这是最直接的类存在性验证
• CI 中加一步 php bin/console lint:yaml config/，避免 YAML 缩进错误导致整个配置失效

真正棘手的问题往往出在条件性服务定义（比如基于环境或 feature flag）、表达式语言（expr）或第三方 Bundle 的扩展点 —— 这些 lint:container 基本不覆盖，得靠实际启动或单元测试捕获。