装包只是第一步，配置错误（网关地址、API密钥、签名格式、模板ID）会导致静默失败或400错误；需核对.env、config/sms.php、签名合规性、模板审核状态及日志响应体。
为什么 composer require 装完包还是发不出验证码？
装包只是第一步，不是“装完就通”。绝大多数失败发生在配置环节——网关地址、API密钥、签名格式、模板ID这四项任意一个填错，send() 就会静默失败或返回 400 Bad Request。尤其注意：不同厂商对「签名」要求差异极大，有的要加【】，有的禁止特殊字符，有的还强制绑定备案过的签名名称。
- 检查
.env中的SMS_PROVIDER是否与实际安装的包匹配（如aliyun、qcloud、juhe） - 确认
config/sms.php里default对应的驱动已正确定义，且credentials数组中键名与包文档严格一致（比如阿里云要access_key_id，腾讯云却是secret_id） - 用
php artisan tinker手动调一次Sms::send('138xxxxxx', 'SMS_123456789', ['code' => '1234'])，别依赖前端表单——先排除调用链路问题
Sms::send() 报 Class 'Sms' not found 怎么办？
这个错误说明 Laravel 没自动加载门面（Facade）或服务提供者（Service Provider）。Composer 安装后，Laravel 5.5+ 通常能自动发现包，但以下情况必须手动注册：
- 使用的是 Laravel config/app.php 的
providers数组里加一行：Overtrue\LaravelSMS\SmsServiceProvider::class - 用了自定义命名空间或 alias → 检查
aliases数组是否包含'Sms' => Overtrue\LaravelSMS\Facade::class - 运行过
composer dump-autoload -o但没清配置缓存 → 执行php artisan config:clear，否则config/sms.php修改不生效
短信发出去了，但用户收不到或延迟严重
发送成功 ≠ 用户收到。常见瓶颈不在代码，而在运营商通道和内容合规性：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 测试手机号是否在白名单内（部分沙箱环境只允许配置过的号码接收）
- 检查短信内容是否含敏感词：「贷款」「微信」「免费」等词可能被拦截，模板审核状态是否为「已通过」（尤其阿里云需单独提交模板并等人工审核）
- 确认发送时间是否在运营商限制时段（如 22:00–07:00 多数通道禁发）
- 用
log查看响应体：dd($response->getBody()->getContents())，重点看返回的MessageId和Code字段，比抛异常更有用
换网关时参数结构不兼容怎么办？
阿里云、腾讯云、聚合数据的 SDK 参数名、错误码、重试逻辑全都不一样。硬写 if-else 切换 provider 很容易漏掉字段或错判失败原因。建议统一抽象一层：
- 定义接口
SmsDriver，声明send(string $phone, string $template, array $data): bool - 每个网关实现类只处理自身协议细节，比如
AliyunSmsDriver把$data['code']映射成TemplateParam字符串，TencentSmsDriver则转成TemplateParamSet数组 - 业务层只依赖接口，切换网关只需改 DI 容器绑定，不用动控制器里的
Sms::send()
真正卡住人的从来不是装包，而是签名格式没对齐、模板没过审、日志没开全——这些地方一漏，排查时间翻倍。
