Skip to content

短信模块 ​


版本与配置 ​

版本 >= 2.1.0(sms4j) ​

已完成 sms4j 集成,文档地址:https://sms4j.com/doc3/

配置方式与厂商扩展请参考 sms4j 文档。

输入图片说明

使用方式可参考 demo 模块示例:

输入图片说明

补充说明:

  • Cloud 版本短信配置通常放在 Nacos 的 ruoyi-resource.yml 中。
  • 当前资源服务已经提供 /resource/sms/code 接口,内部会把验证码写入 Redis,再通过 SmsFactory 发送短信。
  • 发送具体使用哪个通道,取决于 SmsFactory.getSmsBlend("配置key") 中的配置 key。

版本 1.2.0(SPI 方式) ​

短信模块采用 SPI 加载,支持 阿里云、腾讯云,可提交 PR 扩展。

参考 ruoyi-demo 的 pom 配置:

输入图片说明

配置文件示例:

输入图片说明

参数说明:

  • enabled:短信功能开关
  • endpoint:厂家域名
  • accessKeyId:密钥 ID
  • accessKeySecret:密钥
  • signName:签名
  • sdkAppId:应用 ID(腾讯专用)

功能使用 ​

参考 demo 模块 SmsController 示例。
功能采用“模板模式”动态加载厂商模板,注入 SmsTemplate 即可使用。

输入图片说明

补充说明:

  • Cloud 实际项目里更建议参考资源服务 SysSmsController 的实现,以及 ruoyi-example/ruoyi-demo 中的短信演示接口。
  • 功能思路与 Vue 版本一致,可结合 Vue 版本短信模块说明 一起看。

重点须知 ​

不同厂家参数格式差异较大,请按规则配置:

输入图片说明

砚考 · 让每一次考试都经得起检验