装包只是第一步，配置错误（网关地址、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()

真正卡住人的从来不是装包，而是签名格式没对齐、模板没过审、日志没开全——这些地方一漏，排查时间翻倍。