SymfonyNotifier发不出短信主因是未启用SmsTransport或凭据错误：需手动安装网关包（如symfony/aliyun-notifier）、在notifier.yaml中配置sms transport、严格匹配环境变量名，并通过getChannels()或ChannelPolicy路由渠道，而非硬编码。
为什么 SymfonyNotifier 发不出短信，但邮件能正常走？
多半是渠道配置没启用或凭据不匹配。SymfonyNotifier 默认只注册 MailerTransport，SmsTransport 需手动引入并配置具体网关（比如 Twilio、Aliyun、TencentSMS），且必须在 config/packages/notifier.yaml 中显式声明。
- 检查是否已安装对应网关包，例如阿里云短信需
composer require symfony/twilio-notifier（注意：Twilio 包名易误导，阿里云实际用的是symfony/aliyun-notifier） -
notifier.yaml里漏写transports下的sms: 'aliyun://...'这一行，会导致Notification被路由到默认空 transport - 环境变量名必须严格匹配文档，比如
ALIYUN_ACCESS_KEY_ID写成ALIYUN_KEY_ID就静默失败，连日志都不报错
Notification 类里怎么指定发短信还是发邮件？
不靠类本身判断，靠 ChannelPolicy 或 Notification::getChannels() 动态返回。硬编码渠道会锁死扩展性，推荐按场景分离逻辑。
- 发验证码这类强时效通知，直接在
getChannels()返回['sms']；注册欢迎消息这种可异步触达的，返回['email', 'slack'] - 别在
__construct()里传$channel参数再 if-else，Notifier 的设计初衷是让渠道和业务逻辑解耦 - 如果要用策略路由（比如 VIP 用户优先短信+邮件，普通用户只发邮件），得自定义
ChannelPolicy实现，而不是改Notification类
本地开发时如何避免真发短信又验证逻辑？
用 NullTransport 或 ChatzTransport（仅限 Symfony 6.2+）打桩，但要注意测试配置不能污染 prod。
- 开发环境配置
transports: { sms: 'null://' }，它会吞掉所有短信请求，不报错也不发 - 想看内容是否生成正确？换用
chatz://（需装symfony/chatz-notifier），它把通知转成结构化数组输出到 debug toolbar 或日志 - 切记不要在
notifier.yaml里用%env(APP_ENV)%做条件判断——YAML 不支持运行时 env 分支，得拆成notifier_dev.yaml单独导入
TextNotification 和自定义 Notification 子类的区别在哪？
TextNotification 是个轻量封装，只管纯文本内容 + 简单渠道；自己继承 Notification 才能控制模板、上下文、重试策略等细节。
- 发系统告警（带堆栈、服务名、时间戳）必须自定义类，否则
TextNotification没法注入额外上下文数据 -
TextNotification的getContent()返回字符串，而自定义类可返回MessageInterface实例，比如EmailMessage支持附件、HTML 模板路径 - 性能上没差异，但自定义类多了
getOptions()方法，可用于设置 Twilio 的from号码或邮件的priority，这些TextNotification不暴露
最常被跳过的其实是 transport 的异常捕获——Notifier 默认吞掉发送失败异常，除非你手动监听 NotificationFailedEvent 并记录。不加这层，线上短信通道挂了你也收不到告警。
