Symfony服务别名强制指定接口默认实现，仅影响接口类型获取（如get(MyInterface::class)），不参与自动装配；必须定义在services根层级，目标服务ID须已存在，同名别名后定义覆盖先定义，但跨文件时按字母序加载；别名不能解决多实现autowire冲突，需禁用autowire或用bind显式指定；验证需用debug:container --types查接口类型。
Symfony 服务别名不是“起个别名叫着方便”，而是强制指定某个接口的默认实现，它只影响通过接口类型获取服务（如 $container->get(MyInterface::class)），不参与自动装配（autowire）的候选匹配。设错位置、忽略覆盖规则或混淆 alias 和 autowire 行为，是绝大多数配置失效的根本原因。
别名必须写在 services 根层级
别名定义不能嵌套在某个服务的 arguments、bind 或其他块里，必须直接放在 services: 下方一级：
- ✅ 正确写法（YAML）：
App\Contract\LoggerInterface: '@App\Service\FileLogger'
- ❌ 错误写法（别名被忽略）：
App\Service\ReportGenerator:
arguments:
$logger: '@App\Service\FileLogger'
# 这里写 App\Contract\LoggerInterface: '@App\Service\FileLogger' 不生效
- 目标服务 ID 必须已存在（已声明或自动注册），不能是未注册的类名。
别名会覆盖，但顺序不可靠
同名别名后定义的会覆盖先定义的，但若分散在多个 YAML 文件中（如 packages/ 下），加载顺序取决于文件名字母序，不是按加载先后。
- 推荐：把所有别名集中写在
config/services.yaml底部，避免跨文件冲突。 - 特别注意：FrameworkBundle 自动注册了部分别名（如
mailer→symfony.mailer），可能静默覆盖你的定义。
别名不解决 autowire 多实现报错
当你有多个 PaymentProcessorInterface 实现时，设别名并不能让 __construct(PaymentProcessorInterface $p) 自动注入成功——容器仍会报 “multiple services exist”。
- 必须显式禁用该接口的自动装配：
App\Contract\PaymentProcessorInterface: ~
autowire: false
- 或在具体服务中用
bind指定：
App\Service\OrderService:
bind:
$processor: '@App\Service\StripeProcessor'
验证别名是否真正生效
不要只看 YAML 文件，要查容器最终解析结果：
- 运行命令：
php bin/console debug:container --types | grep PaymentProcessorInterface - 如果输出是
alias for "App\Service\StripeProcessor"，说明别名注册成功； - 如果显示的是另一个实现，或根本没出现
alias for，说明被覆盖、写错位置，或目标服务 ID 不存在。 - 注意：
debug:container mailer这类按 ID 查不会显示别名，它只对接口类型查找起作用。
