Spring Boot 集成短信发送功能（以阿里云短信为例）

发布时间：2026/7/17 16:44:34

Spring Boot 集成短信发送功能（以阿里云短信为例）

目录

一. 前置准备工作（创建阿里云OSS服务获取密钥，开通短信服务）

1.1 注册阿里云服务器

1.2 开通短信服务

1.3 创建对象存储OSS服务

1.4 RAM用户授权短信权限

1.5 新增用户并授权用户短信权限

1.6 获取 AccessKey ID 和 AccessKey Secret

二. 项目实战（创建项目编写代码集成短信发送）

2.1 引入依赖

2.2 修改 yml 文件

2.3 创建阿里云短信配置类

2.4 编写 SmsService 短信发送模板业务类

2.5 在业务中调用短信发送的方法

一. 前置准备工作（创建阿里云OSS服务获取密钥，开通短信服务）

这里我们就从申请注册短信模板0基础开始，方便小白同学也能快速上手，如果你已经准备好了短信发送的账户密钥等信息，直接跳至第二部分项目实战。

1.1 注册阿里云服务器

点击链接，直接选择一种登录方式注册登陆即可。

阿里云登录 - 欢迎登录阿里云，安全稳定的云计算服务平台

1.2 开通短信服务

搜索短信服务，点击跳转然后有免费开通。

如下页面，简单过一遍"快速学习与测试"

走完上面的流程，我们点击"国内消息"，然后如右侧页面所示，需要去申请"资质"，只要是项目集成都需要申请"资质"，资质申请审核完毕；到签名页面添加签名，签名会需要使用到申请的资质，签名创建完毕后，添加我们的短信模板，自行选择即可，也可以自定义模板。

创建完毕之后，一定要把"签名"，"短信模板Code码"记下来，一会在代码中会用到。

这里以我的为例，签名是"aliyunSM666"。

短信模板Code为"SMS_481015005"

1.3 创建对象存储OSS服务

左上角搜索输入"对象存储"，即可找到对象存储OSS服务，点击跳转。

然后来到如下页面，点击 Bucket——>创建Bucket 一步步操作即可。

这里需要记一个点，如果创建的地域是北京，那么下面在配置 yml 文件时，aliyun.regionId 的值就是 cn-beijing；如果是杭州，就是 cn-hangzhou；如果是上海，就是cn-shanghai。

1.4 RAM用户授权短信权限

创建完毕 Bucket 完毕后，点击创建的 Bucket 进入详情页。

然后前往RAM控制台

1.5 新增用户并授权用户短信权限

来到RAM控制台，先新增一名用户，然后点击添加权限

在权限策略中输入短信即可搜索到，直接授权给用户即可。

如果之前已经创建过用户，直接授权即可，也可以像下图所示，到授权页面选择指定用户授权不能

1.6 获取 AccessKey ID 和 AccessKey Secret

点击右上角用户头像

跳转到 AccessKey 详情页，如果没有则新建一个即可，

注意！！！AssessKey Secret 新建后不会再展示，首次新建请保存，如果遗忘只需禁用现有的AssessKey，再新建一个即可。

二. 项目实战（创建项目编写代码集成短信发送）

2.1 引入依赖

<!-- 阿里云核心 SDK --> <dependency> <groupId>com.aliyun</groupId> <artifactId>aliyun-java-sdk-core</artifactId> <version>4.5.16</version> </dependency> <!-- 短信服务 SDK --> <dependency> <groupId>com.aliyun</groupId> <artifactId>aliyun-java-sdk-dysmsapi</artifactId> <version>2.1.0</version> </dependency> <!-- OSS SDK --> <dependency> <groupId>com.aliyun.oss</groupId> <artifactId>aliyun-sdk-oss</artifactId> <version>3.15.1</version> </dependency>

2.2 修改 yml 文件

如下图所示，修改项目的 yml 文件，在 yml 文件中添加 aliyun 配置。

assessKeyId 就是上面第一步提到的 AccessKey ID；

accessKeySecret 就是上面提到的 AccessKey Secret；

regionId 就是上面提到的 cn-shanghai；根据自己创建的 Bucket 区域而定。

2.3 创建阿里云短信配置类

在下面配置类中，首先获取 yml 配置文件中设置的值，然后编写返回实例的方法并将值赋值给新建实例。

然后，使用短信客户端实例调用 API 接口发送短信，这里写为一个方法，传递手机号，签名，短信模板Code值，然后再其他业务类型，注入此配置类的实例，调用 sendSms 方法，根据业务需求传递不同的短信Code发送不同的短信。

@Configuration public class AliyunSmsConfig { // 1.阿里云账号的accessKeyId @Value("${aliyun.assessKeyId}") private String accessKeyId; // 2.阿里云账号的accessKeySecret @Value("${aliyun.assessKeySecret}") private String accessKeySecret; // 3.阿里云账号的regionId @Value("${aliyun.regionId}") private String regionId; // 创建并初始化阿里云短信服务的客户端实例 @Bean public IAcsClient acsClient() { DefaultProfile profile = DefaultProfile.getProfile(regionId, accessKeyId, accessKeySecret); return new DefaultAcsClient(profile); } // 发送短信的核心逻辑，通过 IAcsClient 调用阿里云短信服务 API public SendSmsResponse sendSms(String phoneNumber, String signName, String templateCode, String templateParam) throws Exception { IAcsClient client = acsClient(); SendSmsRequest request = new SendSmsRequest(); request.setPhoneNumbers(phoneNumber); request.setSignName(signName); request.setTemplateCode(templateCode); request.setTemplateParam(templateParam); return client.getAcsResponse(request); } }

2.4 编写 SmsService 短信发送模板业务类

在上面，我们已经定义好了发送短信的方法，按道理来说，直接 @Autowired 注入 配置的 Bean 实例就可以了，但是我们观察上方方法，其实还不够简洁，因为 sendSms 方法中，只有 phone 手机号一个参数是需要用户传递的，其他的参数是不需要的。

因此，我们最好再进行一层抽取，将每一种发送短信验证码的方法写成一个 Service 业务类，这样一来其他类当要发送短信的时候，直接调用封装好的 Service 中的方法即可，优化了原本的业务类代码。

如下代码所示，

定义一个发送登录验证码的方法 "sendLoginVerificationCode"，还可以定义发送修改密码的验证码 "sendUpdatePasswordVerificationCode"，还可以定义付钱的验证码方法 "sendPayMoneyVerificationCode"。

当然啦，这里只是举个例子，实际业务项目中，需要发送的短信验证码肯定也是多种多样的，可以定义多个方法，也可以定义一个通用方法，都是可以的，小编这里就采用这种常用写法啦。

@Service @Slf4j public class SmsService { @Autowired private AliyunSmsConfig aliyunSmsConfig; public boolean sendLoginVerificationCode(String phoneNumber, String code) { try { SendSmsResponse response = aliyunSmsConfig.sendSms( phoneNumber, "aliyunSMS666", "SMS_481015005", "{\"code\":\"" + code + "\"}" ); log.info(response.getCode()); return "OK".equals(response.getCode()); } catch (Exception e) { e.printStackTrace(); return false; } } public boolean sendUpdatePasswordVerificationCode(String phoneNumber, String code) { try { SendSmsResponse response = aliyunSmsConfig.sendSms( phoneNumber, "aliyunSMS666", "SMS_481015005", "{\"code\":\"" + code + "\"}" ); log.info(response.getCode()); return "OK".equals(response.getCode()); } catch (Exception e) { e.printStackTrace(); return false; } } public boolean sendPayMoneyVerificationCode(String phoneNumber, String code) { ...... } }

2.5 在业务中调用短信发送的方法

上面的工作都做完之后，我们就可以进入到真正的业务层了，如下代码，其实非常简单，这里小编定义了五个方法，其实这里的 sendCode 方法是可以不用要的，毕竟代码不多，也可以直接将代码写入到 login 登陆方法中。

"selectByUsername" 查询用户方法；

"sendCode"发送短信方法；

"login" 登陆方法；

"createUser" 创建新用户方法；

"generateTokenByUid" 生成用户 token 方法；

逻辑很简单，都有注释，大家一步一步看即可。

@Service public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService { // 添加类顶部声明 private static final Logger logger = LoggerFactory.getLogger(UserServiceImpl.class); @Autowired private UserMapper userMapper; @Autowired private SmsService smsService; @Autowired private StringRedisTemplate stringRedisTemplate; // 方法一： 根据用户名查询用户是否已存在 @Override public Boolean selectByUsername(String username) { return !userMapper.selectByUserName(username).isEmpty(); } /* 方法二： 发送短信方法 */ public Boolean sendCode(String phone) { // 1. 生成6位随机数作为验证码 SecureRandom secureRandom = new SecureRandom(); String code = String.valueOf(100000 + secureRandom.nextInt(900000)); // 2. 将验证码存入Redis stringRedisTemplate.opsForValue().set(phone,String.valueOf(code),5, java.util.concurrent.TimeUnit.MINUTES); // 3. 发送验证码 try { logger.info("准备发送验证码,手机号：{}，验证码：{}",phone,code); return smsService.sendLoginVerificationCode(phone, code); } catch (Exception e) { logger.error("短信发送失败，手机号：{}，错误信息：{}", phone, e.getMessage(), e); return false; } } /* 方法三：用户登录+注册接口综合方法 */ public Result<Boolean> login(LoginDto loginDto, HttpServletRequest request, HttpServletResponse response){ Result<Boolean> result = new Result<>(); // 1. 登陆方式一: 手机号+短信登录 if (loginDto.getPhone() != null && loginDto.getCode() != null){ List<User> users = userMapper.selectUserByPhone(loginDto.getPhone()); if (users.isEmpty()){ createUser(loginDto); } String code = stringRedisTemplate.opsForValue().get(loginDto.getPhone()); if (code != null && code.equals(loginDto.getCode())){ generateTokenByUid(users.get(0).getId(), request, response); result.setCode(200); result.setData(true); result.setMsg("success"); }else{ result.setCode(999); result.setMsg("验证码错误"); result.setData(false); } return result; } // 2. 登陆方式二:手机号+密码登录 else if (loginDto.getUsername() != null && loginDto.getPassword() != null){ User user = userMapper.selectOne(new QueryWrapper<User>().eq("username", loginDto.getUsername())); if (user != null && MD5Utils.md5HashWithSalt(loginDto.getPassword(), user.getSalt()).equals(user.getPassword())){ generateTokenByUid(user.getId(), request, response); result.setCode(200); result.setData(true); result.setMsg("success"); }else{ result.setCode(999); result.setMsg("密码错误"); result.setData(false); } result.setCode(999); result.setMsg("未知错误"); result.setData(false); return result; } // 3. 登陆方式三：用户名+密码登录 else if (loginDto.getUsername() != null || loginDto.getPassword() != null) { User user = userMapper.selectOne(new QueryWrapper<User>().eq("username", loginDto.getUsername())); if (user != null && MD5Utils.md5HashWithSalt(loginDto.getPassword(), user.getSalt()).equals(user.getPassword())){ generateTokenByUid(user.getId(), request, response); result.setCode(200); result.setData(true); result.setMsg("success"); }else if (user == null && loginDto.getPassword() != null && loginDto.getPassword2() != null && loginDto.getPassword().equals(loginDto.getPassword2())){ User newUser = createUser(loginDto); generateTokenByUid(newUser.getId(), request, response); }else { result.setCode(999); result.setMsg("密码错误"); result.setData(false); } } result.setCode(999); result.setMsg("未知错误"); result.setData(false); return result; } /* 方法四：创建新用户方法 */ public User createUser(LoginDto loginDto){ User user = new User(); user.setPhone(loginDto.getPhone()); user.setStatus(0); if (loginDto.getUsername() != null){ user.setUsername(loginDto.getUsername()); // 生成随机密码盐值字符串 String salt = UUID.randomUUID().toString().replaceAll("-", ""); user.setSalt(salt); user.setPassword(MD5Utils.md5HashWithSalt(loginDto.getPassword(), salt)); } user.setAvatar("https://image-1300566513.cos.ap-guangzhou.myqcloud.com/upload/images/5a9f48118166308daba8b6da7e466aab.jpg"); user.setCreated(LocalDateTime.now()); userMapper.insert(user); return user; } /* 方法五：生成 Token 方法*/ public void generateTokenByUid(Long uid, HttpServletRequest request, HttpServletResponse response){ String token = JwtUtils.generateToken(uid); response.setHeader("Authorization", token); response.setHeader("Access-control-Expose-Headers", "Authorization"); } }

相关新闻

SuperHTML终极指南：从代码整洁到开发者体验的完整解决方案

SuperHTML终极指南：从代码整洁到开发者体验的完整解决方案

SuperHTML终极指南&#xff1a;从代码整洁到开发者体验的完整解决方案 【免费下载链接】superhtml HTML Validator, Formatter, LSP, and Templating Language Library 项目地址: https://gitcode.com/gh_mirrors/su/superhtml 在当今前端开发中&#xff0c;HTML代码质量…

2026/7/17 16:44:00
Visual C++运行库一键修复工具：如何快速解决Windows软件兼容性问题

Visual C++运行库一键修复工具：如何快速解决Windows软件兼容性问题

Visual C运行库一键修复工具&#xff1a;如何快速解决Windows软件兼容性问题 【免费下载链接】vcredist AIO Repack for latest Microsoft Visual C Redistributable Runtimes 项目地址: https://gitcode.com/gh_mirrors/vc/vcredist 你是否曾经遇到过软件打不开、游戏闪…

2026/7/17 16:44:00
3分钟解锁苹果字体：PingFangSC跨平台使用全攻略

3分钟解锁苹果字体：PingFangSC跨平台使用全攻略

3分钟解锁苹果字体&#xff1a;PingFangSC跨平台使用全攻略 【免费下载链接】PingFangSC PingFangSC字体包文件、苹果平方字体文件&#xff0c;包含ttf和woff2格式 项目地址: https://gitcode.com/gh_mirrors/pi/PingFangSC 还在为Windows和Linux系统上单调的中文字体而…

2026/7/17 16:44:00

最新新闻

PilotGo运维平台入门：从安装到集群管理的完整指南

PilotGo运维平台入门：从安装到集群管理的完整指南

PilotGo运维平台入门&#xff1a;从安装到集群管理的完整指南 【免费下载链接】PilotGo PilotGo is a plugable operation platform written in go. 项目地址: https://gitcode.com/openeuler/PilotGo 前往项目官网免费下载&#xff1a;https://ar.openeuler.org/ar/ 想…

2026/7/17 17:53:21
2026年7月最新——南京靠谱防水公司推荐：实测对比后的客观结论 - 吉林同城获客

2026年7月最新——南京靠谱防水公司推荐：实测对比后的客观结论 - 吉林同城获客

2026年7月最新——南京靠谱防水公司推荐：实测对比后的客观结论 南京本地超人防水补漏，全国连锁直营、南京各区常驻班组的专业防水补漏公司，主城核心片区日间约30分钟上门。24小时服务热线：4009090918、18053407167…

2026/7/17 17:53:21
一个慢样本：观察三生（中国）的长期主义实践 - 速递信息

一个慢样本：观察三生（中国）的长期主义实践 - 速递信息

为什么值得观察？在大健康产业，"快"是常见的叙事——快速融资、快速扩张、快速变现。在这样的语境下，有一家企业显得"格格不入"。它创立于2004年，经历了行业数次剧烈洗牌，却始终保持着一种近乎…

2026/7/17 17:53:21
Falcon-H1-Tiny：轻量化AI模型在边缘设备的部署与优化

Falcon-H1-Tiny：轻量化AI模型在边缘设备的部署与优化

1. 项目概述&#xff1a;Falcon-H1-Tiny的轻量化革命 在AI大模型普遍追求千亿参数的今天&#xff0c;Falcon-H1-Tiny选择了一条截然不同的技术路线——通过仅100M参数的极致精简设计&#xff0c;实现了在树莓派、手机等边缘设备上的流畅推理。这个项目最吸引我的地方在于它打破…

2026/7/17 17:53:21
Subagent 不是万能的：这些场景用了反而更糟

Subagent 不是万能的：这些场景用了反而更糟

TL;DR&#xff1a; Subagent 不适合所有复杂任务。需要频繁共享细节、连续编辑同一批文件、上下文高度耦合的任务&#xff0c;留在主会话更稳。不是所有任务都值得隔离——有时候隔离本身就是成本。 问题 看到 Subagent 后&#xff0c;很容易把所有任务都拆出去。结果是多个代理…

2026/7/17 17:53:22
计算机毕业设计之jsp中小型企业仓库管理系统

计算机毕业设计之jsp中小型企业仓库管理系统

网络的广泛应用给生活带来了十分的便利。所以把中小型企业仓库管理与现在网络相结合&#xff0c;利用JSP技术建设中小型企业仓库管理系统&#xff0c;实现中小型企业仓库管理系统的信息化。则对于进一步提高企业的发展&#xff0c;丰富中小型企业仓库管理经验能起到不少的促进作…

2026/7/17 17:53:22

日新闻

VS Code 高效配置与个性化定制全攻略

VS Code 高效配置与个性化定制全攻略

1. VS Code 高效配置基础作为一款轻量级但功能强大的代码编辑器&#xff0c;VS Code 的默认配置已经能满足基本需求&#xff0c;但通过合理调整设置可以大幅提升编码效率。我使用 VS Code 已经有五年多时间&#xff0c;期间尝试过各种配置方案&#xff0c;总结出这套适合大多数…

2026/7/17 0:00:12
从竞赛代码到桌面工具：让 SuperADD 与 SubspaceAD 真正跑进自己的图像

从竞赛代码到桌面工具：让 SuperADD 与 SubspaceAD 真正跑进自己的图像

在异常检测领域，很多优秀算法最初都是以研究代码的形式发布的。它们能够在固定测试集上复现实验结果，却不一定能被普通用户直接拿来测试自己的图片。尤其是最近很多算法仅提供在固定测试集的测试环境，而gradio的demo演示也不会提供。 对工程应用和在自己的图片上进行测试来…

2026/7/17 0:00:12
WinRAR高效配置指南：从基础安装到高级压缩实战

WinRAR高效配置指南：从基础安装到高级压缩实战

前几天帮同事处理一个客户发来的压缩包&#xff0c;解压时系统自带的工具弹出一串乱码&#xff0c;换用 WinRAR 却顺利打开了。这种看似简单的场景&#xff0c;恰恰暴露了不同压缩工具在处理非标准编码、分卷压缩或加密文件时的差异。WinRAR 作为一款老牌工具&#xff0c;真正价…

2026/7/17 0:00:12

周新闻

PlantUML 实战：5分钟将 UML 2.5 序列图转换为可执行代码草图

PlantUML 实战：5分钟将 UML 2.5 序列图转换为可执行代码草图

PlantUML 实战&#xff1a;5分钟将 UML 2.5 序列图转换为可执行代码草图 在软件开发过程中&#xff0c;清晰的系统设计往往比编码本身更为关键。传统拖拽式UML工具虽然直观&#xff0c;却常常成为效率杀手——频繁的鼠标操作打断设计思路&#xff0c;版本控制困难&#xff0c;…

2026/7/17 13:27:52
【RT-DETR涨点改进】29 动态Batch推理：让RT-DETR在低延迟下吃满GPU算力

【RT-DETR涨点改进】29 动态Batch推理：让RT-DETR在低延迟下吃满GPU算力

29 动态Batch推理：让RT-DETR在低延迟下吃满GPU算力 开篇故事 上个月帮一家安防厂商做项目优化，他们用RT-DETR做实时人流统计，部署在NVIDIA A10上。客户反馈说：“GPU利用率才30%，但延迟已经飙到40ms了，加人流量就丢帧。” 我远程一看，好家伙——生产环境里每个请求单独…

2026/7/17 13:27:47
Postman 环境变量实战：3种动态设置方法与CI/CD集成避坑指南

Postman 环境变量实战：3种动态设置方法与CI/CD集成避坑指南

Postman 环境变量高阶实战&#xff1a;动态管理与 CI/CD 深度集成在接口自动化测试领域&#xff0c;环境变量的灵活运用往往成为区分初级与高级测试工程师的关键能力。本文将深入探讨 Postman 环境变量的三种动态设置模式&#xff0c;并分享 Newman 在 CI/CD 流水线中的实战避坑…

2026/7/17 13:27:42

月新闻

[C++]内存管理：串顺序存储的内存回收

[C++]内存管理：串顺序存储的内存回收

在串&#xff08;字符串&#xff09;的顺序存储中&#xff0c;内存回收的方式取决于字符串的存储方式以及所使用的编程语言和相关库。以下以 C 为例进行说明&#xff0c;因为 C 对内存管理有较为直接的控制。 1. 基于 char 数组的串顺序存储 如果使用普通的 char 数组来存储字…

2026/7/17 13:27:56
移动端游戏功耗测试实战：电流、功率、亮度和场景对比

移动端游戏功耗测试实战：电流、功率、亮度和场景对比

移动端游戏功耗测试：先控制变量，再比较优化是否真的省电 摘要：功耗测试最容易犯的错误，是拿两次不同温度、不同亮度、不同场景的平均功率直接比较。本文给出一套可复现的游戏功耗测试方法，覆盖引擎特性验证、版本回归和黑盒体验测试，并说明如何把功耗与帧率、温控、CPU/G…

2026/7/16 12:50:02
足球口袋教练 HarmonyOS 离线应用实战（03/20）：ArkUI 首页仪表盘搭建

足球口袋教练 HarmonyOS 离线应用实战（03/20）：ArkUI 首页仪表盘搭建

本文是“足球口袋教练 HarmonyOS 离线应用实战”系列第 3 篇。示例项目是一个 HarmonyOS / ArkTS / ArkUI 编写的离线足球训练助手&#xff0c;围绕真实页面、真实截图和可复现操作展开。 本篇要解决的问题 训练 App 的首页不能只展示欢迎语&#xff0c;它要解决“我现在该点哪…

2026/7/16 12:06:05