gzdyj 的博客

2025 年终总结

Thu, 23 Jul 2026 00:00:00 GMT

2025 年终总结#

记忆就像一杯水，时间就像一个打开的水龙头，岁月如斯，杯中的水越来越淡。一晃又到了 25 年底。回想 24 年总结时说到的期中总结，因为懒癌一直没能动笔。一方面生活进入了舒适区，工作占据了大部分的生活，每天都在办公室的日光灯下分不清昼夜；剩余休闲时间更想找好友出去踏青游玩。今天也是因为流感病假的第四天，希望趁病痛的理性还没有被完全康复的欢愉冲散之前，能把一些有印象有意义的内容记录下来。

工作#

工作上整体还是按部就班、保持严谨、提高技术、追求完美。相较于去年，今年 AI 工具的发展对编码方式造成了很大的改变。AI 的上下文关联、agent、自动搜索能力有了很大的提升，当前最热门的一个词 vibe coding，指的就是完全通过自然语言对话来完成工作中的编码、调试、测试。这极大地解放了双手，把一些可控的、重复性的作业交给 AI 可以完美搞定。在后端上有的复杂逻辑可能还需要反复核对，但在前端上只需要把思路想法清晰表达出来，AI 甚至一次就能搞定。

虽然 AI 极大提高了当前的效率，但新事物产生必然带来变革。AI 抹平了很大一部分经验的作用，但又没有创造太多新的岗位需求。作为浪潮下的普通人，可能只有最大限度地拥抱变化，积累储蓄应对未来的不确定性。

学习#

学习上今年还算马马虎虎，自考过了四门。虽然也不指望这个有啥用，更多的是给自己找个终身学习途中的短暂目标。因为考试今年重新体系化学习了中国近现代史和马克思原理，虽然也是囫囵吞枣，但也受益良多。马原哲学教我们从一个更抽象更高维度的角度来看问题，近现代史则让我对那段时间线和重大会议的作用有了全新了解。

通过学习了一些理财、储蓄相关知识，年初定的储蓄目标逐步按计划完成。理财有赚有亏，整体盈利，不过没到手的终究只能算浮利。

今年对学习方法也有一些更新：对不熟悉的领域主要以视频和好理解的入门文章为主，书籍放到最后用来深入查漏补缺。对于不同观点尽量采用否定之否定思想。

身体#

身体锻炼上，相较去年是连滚带爬，不然也不会一个月反复感冒。在今年暑假期间拔了两颗阻生智齿后，锻炼就开始躺平。今年体检也是各种小毛病异常——一方面是胡吃海喝，一方面是熬夜。一个人独居过于自由，再加上常年吹空调室内外温差过大，熬夜沉迷奶头乐懒惰导致。

身体锻炼将是 2026 年的规划的核心问题之一，需要规律作息、增加热量缺口减轻体重，管住嘴迈开腿。

书评#

小狗钱钱#

当你定下了大目标的时候，就意味着你必须付出比别人多得多的努力

一本儿童读物，但是对于一开始对理财一窍不通的人来说，是很好的一门入门书。按照书中的方式今年提前了两个月完成了计划储蓄。

你是吃出来的 2#

饮食不要偏颇和极端，混合杂吃多样性

看完更加坚信物质决定意识，意识反作用于物质了。工作之后就一直在长胖，核心原因还是因为工作后久坐，新陈代谢过低，下班后又经常犒劳自己。在办公室接触阳光过少，缺少维生素 D 导致免疫力低下。

MongoDB 进阶与实践#

MongoDB 索引，存储引擎，并发原理（MVCC），锁机制，oplog 等设计与 MySQL 是一致的

书到用时方恨少，工作抽时间给自己查漏补缺，遇到相关文档就更加游刃有余。

禅与摩托车维修艺术#

当你做某件事的时候，一旦想要求快，就表示你再不关心它，而想去做别的事

文章主要是讲旅行和修摩托车，看得深有感悟。说是修摩托车，但讲的道理是对所有技术人员共通的。

中国哲学简史#

人必须先说很多话，然后保持静默

跟父母聊天有思想冲突时去看的，想着能不能找到他们为什么会有这样思想的原因。很多思想其实已经融入了血脉，看了书之后跟人才对号入座上。

游戏#

苍之彼方的四重奏：剧情、音乐都是第一梯队，四位女主角塑造得非常成功。欣赏艺术是一种享受。

王者荣耀：时隔一两个月会偶尔玩两把，作为工作中午吃完饭消遣挺好。段位高了容易有分奴倾向。

三角洲行动：玩了九十多个小时，作为工作之余放假休息消遣不错。不需要氪金，也有人机给你框框杀，入门上手难度不高。

游戏最后的核心还是和朋友一起玩。

番剧#

今年看的番剧还挺多的，发现自己不是不爱看番，是对新番兴趣不大，主要看的一些老番。

山田君与 7 个魔女
盾勇
转生公主与天才千金的魔法变革
欢迎来到实力主义至上教室第三季
凡人修仙传
遮天
魔女之旅
影之实力者
我的青春恋爱物语果然有问题（二刷）
骑士与魔法（二刷）
关于我转生变成史莱姆这档事
别当欧尼酱了（二刷）
异世界舅舅
魔法少女小圆系列

电影#

名侦探柯南：迷宫的十字路口
哪吒之魔童闹海
恶意
名侦探柯南：独眼的残像
死神来了：血脉诅咒
赎梦
蛟龙行动
鬼灭之刃：无限城篇
疯狂动物城 2
闻香识女人
唐探 1900
霾下之悘（珞珈山剧院话剧）
开心晚宴（湖北剧院话剧）

旅游#

出门多受的罪多，但是沿途的新鲜感是在本地体会不到的。

江西庐山：淡季免门票去的，山下太阳照得十分温暖，山顶都是雪，台阶两边雪踩成了冰，只能垫着脚走中间。可惜行程比较赶，去完五老峰就筋疲力尽了，没有去到三叠泉。

湖南长沙：下班连夜绿皮出发，晚上车上的脚臭味和烟味至今难忘。第二次去长沙才打开了新大门，体验到了什么叫夜生活——24 小时的火锅店，24 小时的蜜雪冰城。爬完了上次没上去的岳麓山，山顶的微风和鸟瞰整个长沙市区的风景独一档。

安徽天堂寨：国庆时期去的。去的路上随着海拔提高逐渐到了云层中，视野极差还下着雨，然后过了一个隧道后突然一片晴朗。景区楼梯架在山体悬崖边，人多走得一晃一晃还挺害怕。山顶的空气是我呼吸过最清新的。下山体验了一把索道，对于前两天才看过索道原理的人来说还是过于刺激了。

使用 acme.sh 申请泛域名 SSL 证书

Thu, 23 Jul 2026 00:00:00 GMT

使用 acme.sh 申请泛域名 SSL 证书#

Let’s Encrypt 提供免费的泛域名证书（Wildcard Certificate），配合 acme.sh 脚本可以全自动申请和续期，非常适合个人站点。

安装 acme.sh#

Terminal window

1
curl https://get.acme.sh | sh -s email=my@example.com

申请证书（Cloudflare DNS API）#

1. 获取 Cloudflare API Key#

2. 配置 API Key#

Terminal window

1
export CF_Key="your-cloudflare-api-key"
2
export CF_Email="your-cloudflare-email"

3. 申请泛域名证书#

Terminal window

1
# 替换为自己的域名
2
./acme.sh --issue --dns dns_cf -d example.com -d *.example.com

4. 验证#

证书会默认安装到 ~/.acme.sh/ 目录下。查看自动续期任务：

Terminal window

1
crontab -l

acme.sh 会自动添加定时任务，证书到期前自动续期。

与 Nginx Proxy Manager 配合#

将生成的证书文件拷贝到 NPM 的对应目录，或在 NPM 中手动上传证书。

注意事项#

阿里云 DNS、腾讯云 DNS 等也有对应的 DNS API 脚本，可在 acme.sh 官方仓库找到
泛域名证书仅支持 DNS 验证方式，不支持 HTTP 验证
证书有效期 90 天，acme.sh 会自动续期，无需额外操作

参考#

Docker 镜像与容器导入导出命令详解

Thu, 23 Jul 2026 00:00:00 GMT

Docker 镜像与容器导入导出命令详解#

Docker 提供了多组镜像和容器的导入导出命令，初学者容易混淆。本文梳理它们之间的核心区别。

docker export / docker import#

作用于容器，导出的是容器当前文件系统的快照。

Terminal window

1
# 导出容器快照
2
docker export container-id > snapshot.tar
3

4
# 导入为镜像
5
docker import snapshot.tar new-image-name:tag

特点：

只保留从镜像启动到 export 时对文件系统的修改，丢弃历史层和元数据
导出的包体积较小（只有一层文件系统）
导入时必须指定新镜像名称和 tag
导入后的镜像启动必须加 /bin/bash 或其他 entrypoint

适用场景： 制作基础镜像。例如从 ubuntu 镜像启动容器，安装软件后导出为基础镜像分发给其他人。

docker commit#

作用于容器，将容器的修改保存为新的镜像。

Terminal window

1
docker commit container-id new-image-name:tag

常用选项：

-a：作者信息
-m：提交说明
-p：提交时暂停容器运行

特点：

保存了容器的读写层 + 镜像原有的历史层
原本 N 层的镜像，commit 后会变成 N+1 层
可以保留启动命令等元数据

适用场景： 快速保存调试环境的修改，生成可复用的镜像。

docker save / docker load#

作用于镜像，导出的是完整的镜像分层结构。

Terminal window

1
# 导出镜像
2
docker save -o image.tar image-name:tag
3

4
# 导入镜像
5
docker load -i image.tar

特点：

保留完整的分层结构和元数据
包体积比 export 大（包含所有历史层）
load 无法重命名镜像，import 可以指定新名称

适用场景： 离线环境迁移镜像。在没有外网的生产服务器上，先在有网的机器上 pull 镜像，save 打包后拷贝到生产环境再 load。

核心区别总结#

命令	作用对象	保留历史层	包体积	导入后可重命名
`docker export`	容器	❌ 只有一层	小	✅
`docker commit`	容器	✅ 增加一层	中	✅
`docker save`	镜像	✅ 完整保留	大	❌
`docker load`	镜像	✅ 完整保留	大	❌
`docker import`	快照文件	❌ 只有一层	小	✅

一句话记忆法：save/load 是对镜像操作，export/import 是对容器操作，commit 是容器→镜像的桥梁。

使用 Docker 完成 Nacos 集群部署

Thu, 23 Jul 2026 00:00:00 GMT

使用 Docker 完成 Nacos 集群部署#

拉取镜像#

Terminal window

1
docker pull nacos/nacos-server:v2.2.0

不要拉 latest 标签，生产环境务必指定版本号。

数据库准备#

Nacos 集群需要 MySQL 存储配置数据。建议使用 MySQL 5.7。

创建数据库 nacos_config，并执行 Nacos 官方提供的数据库初始化脚本（可在 Nacos 源码的 distribution/conf/nacos-mysql.sql 中找到，包含 config_info、config_info_aggr、users、roles 等核心表）。

创建 Nacos 容器#

创建三个 Nacos 实例组成集群。将以下命令中的 IP 地址替换为你的服务器 IP。

节点 1（端口 8848）#

Terminal window展开收起

1
docker run -d \
2
  -e PREFER_HOST_MODE=hostname \
3
  -e MODE=cluster \
4
  -e NACOS_APPLICATION_PORT=8848 \
5
  -e NACOS_SERVERS="your-server-ip:8848 your-server-ip:8858 your-server-ip:8868" \
6
  -e SPRING_DATASOURCE_PLATFORM=mysql \
7
  -e MYSQL_SERVICE_HOST=your-server-ip \
8
  -e MYSQL_SERVICE_PORT=3306 \
9
  -e MYSQL_SERVICE_USER=root \
10
  -e MYSQL_SERVICE_PASSWORD=your-password \
11
  -e MYSQL_SERVICE_DB_NAME=nacos_config \
12
  -e NACOS_SERVER_IP=your-server-ip \
13
  -p 8848:8848 -p 9848:9848 -p 9849:9849 \
14
  --name my-nacos1 \
15
  nacos/nacos-server:v2.2.0

展开收起

节点 2（端口 8858）#

Terminal window展开收起

1
docker run -d \
2
  -e PREFER_HOST_MODE=hostname \
3
  -e MODE=cluster \
4
  -e NACOS_APPLICATION_PORT=8858 \
5
  -e NACOS_SERVERS="your-server-ip:8848 your-server-ip:8858 your-server-ip:8868" \
6
  -e SPRING_DATASOURCE_PLATFORM=mysql \
7
  -e MYSQL_SERVICE_HOST=your-server-ip \
8
  -e MYSQL_SERVICE_PORT=3306 \
9
  -e MYSQL_SERVICE_USER=root \
10
  -e MYSQL_SERVICE_PASSWORD=your-password \
11
  -e MYSQL_SERVICE_DB_NAME=nacos_config \
12
  -e NACOS_SERVER_IP=your-server-ip \
13
  -p 8858:8858 -p 9858:9858 -p 9859:9859 \
14
  --name my-nacos2 \
15
  nacos/nacos-server:v2.2.0

展开收起

节点 3（端口 8868）#

Terminal window展开收起

1
docker run -d \
2
  -e PREFER_HOST_MODE=hostname \
3
  -e MODE=cluster \
4
  -e NACOS_APPLICATION_PORT=8868 \
5
  -e NACOS_SERVERS="your-server-ip:8848 your-server-ip:8858 your-server-ip:8868" \
6
  -e SPRING_DATASOURCE_PLATFORM=mysql \
7
  -e MYSQL_SERVICE_HOST=your-server-ip \
8
  -e MYSQL_SERVICE_PORT=3306 \
9
  -e MYSQL_SERVICE_USER=root \
10
  -e MYSQL_SERVICE_PASSWORD=your-password \
11
  -e MYSQL_SERVICE_DB_NAME=nacos_config \
12
  -e NACOS_SERVER_IP=your-server-ip \
13
  -p 8868:8868 -p 9868:9868 -p 9869:9869 \
14
  --name my-nacos3 \
15
  nacos/nacos-server:v2.2.0

展开收起

验证集群#

访问任意节点的 http://ip:port/nacos，默认用户名密码为 nacos/nacos。在”集群管理”页面可以看到三个节点。

Nginx 负载均衡#

配置 upstream#

在 Nginx Proxy Manager 的安装目录下创建自定义配置：

/path/to/npm/data/nginx/custom/http.conf

1
upstream nacos {
2
    server your-server-ip:8848;
3
    server your-server-ip:8858;
4
    server your-server-ip:8868;
5
}

配置反向代理#

在 NPM 管理页面添加代理：

1
Domain: nacos.your-domain.com
2
Forward Hostname: 127.0.0.1
3
Forward Port: 80

然后在 Advanced 中添加：

1
location / {
2
    proxy_pass http://nacos;
3
}

配置 SSL 证书后，即可通过 https://nacos.your-domain.com/nacos 访问 Nacos 管理页面。

注意：如果使用 Nginx Proxy Manager，需要在容器挂载目录的 nginx/custom/ 下创建 http.conf，NPM 会自动引入该文件到全局配置中。

参考#

利用 Scoop 自由切换 Java (JDK) 版本

Thu, 23 Jul 2026 00:00:00 GMT

利用 Scoop 自由切换 Java (JDK) 版本#

日常开发中经常需要在 Java 8、Java 11、Java 17、Java 21 等不同 JDK 版本之间切换。手动卸载重装非常麻烦，还要清理注册表残留。使用 Scoop 包管理可以轻松解决这个问题。

安装 Scoop#

打开 PowerShell，执行：

Terminal window

1
# 允许本地脚本执行
2
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
3

4
# 安装 Scoop
5
iwr -useb get.scoop.sh | iex
6

7
# 验证安装
8
scoop help

安装多版本 JDK#

1. 添加 Java 仓库#

Terminal window

1
scoop bucket add java

2. 查看可用的 JDK 版本#

Terminal window

1
scoop search jdk

3. 安装不同版本#

Terminal window

1
# 安装 OpenJDK 8
2
scoop install openjdk8-redhat
3

4
# 安装 OpenJDK 21
5
scoop install openjdk21

4. 切换 JDK 版本#

Terminal window

1
# 切换到 JDK 8
2
scoop reset openjdk8-redhat
3

4
# 切换到 JDK 21
5
scoop reset openjdk21
6

7
# 切换到 GraalVM 21
8
scoop reset graalvm21-jdk21

之前手动安装过 JDK 的，建议把系统环境变量 JAVA_HOME 删掉，Scoop 会自动管理用户级别的 JAVA_HOME。

原理#

scoop reset 会更新用户环境变量中的 JAVA_HOME 和 PATH，指向对应版本的安装目录。切换后新开的终端窗口立即生效，无需重启。

同理，Python、Ruby、Node.js 等也可以通过 Scoop 进行多版本管理。

服务器日常初始化指南

Thu, 23 Jul 2026 00:00:00 GMT

服务器日常初始化指南#

1. 系统更新#

Terminal window

1
apt update
2
apt upgrade -y

2. 安全防护#

修改 SSH 端口#

编辑 SSH 配置文件 /etc/ssh/sshd_config，将默认的 22 端口修改为其他端口：

Terminal window

1
vim /etc/ssh/sshd_config
2
# 找到 #Port 22，修改为 Port your-port
3
# 保存后重启服务
4
systemctl restart ssh

创建非 root 用户#

Terminal window

1
# 创建新用户
2
adduser your-username
3

4
# 安装 sudo
5
apt install sudo
6

7
# 将用户添加到 sudo 组
8
usermod -aG sudo your-username
9

10
# 或编辑 /etc/sudoers 添加：
11
# your-username ALL=(ALL) NOPASSWD: ALL

禁用 root 远程登录#

Terminal window

1
# 在 /etc/ssh/sshd_config 中修改
2
PermitRootLogin no

SSH 密钥登录 + 禁用密码#

Terminal window

1
# 在本地生成密钥对，将公钥复制到服务器
2
ssh-copy-id your-username@your-server-ip
3

4
# 在 /etc/ssh/sshd_config 中配置：
5
PasswordAuthentication no
6
PubkeyAuthentication yes
7

8
# 重启服务
9
sudo systemctl restart ssh

3. 常用软件安装#

Docker#

参考腾讯云 Docker 搭建文档。

Nginx Proxy Manager#

推荐使用 Docker 安装 NPM，配合图形化管理反向代理和 SSL 证书。

SSL 证书#

使用 acme.sh + Cloudflare DNS API 申请泛域名证书，自动续期。

内网穿透#

使用 frp 实现内网穿透，配置文件已采用新的 TOML 格式。

Alist#

多存储挂载工具，Docker 一键部署，详见 Alist 官方文档。

防火墙#

修改 SSH 端口后记得在防火墙放行新端口
使用 iptables 应对 SYN 攻击、CC 攻击等
仅开放必要的端口（80、443、SSH 端口等）

SpringBoot 邮件发送与异步优化

Thu, 23 Jul 2026 00:00:00 GMT

SpringBoot 邮件发送与异步优化#

基础配置#

1. 引入依赖#

1
<dependency>
2
    <groupId>org.springframework.boot</groupId>
3
    <artifactId>spring-boot-starter-mail</artifactId>
4
</dependency>

2. 配置邮箱参数#

1
spring:
2
  mail:
3
    username: your-email@example.com
4
    password: your-auth-code
5
    host: smtp.163.com

密码处填写的是邮箱的 授权码，不是邮箱登录密码。以 163 邮箱为例，需要在设置 → POP3/SMTP/IMAP 中开启服务并获取授权码。

3. 发送简单邮件#

1
@RestController
2
@RequiredArgsConstructor
3
public class EmailController {
4

5
    private final JavaMailSender javaMailSender;
6

7
    @GetMapping("/send-email")
8
    public String sendEmail(String email) {
9
        SimpleMailMessage message = new SimpleMailMessage();
10
        message.setFrom("your-name<your-email@example.com>");
11
        message.setTo(email);
12
        message.setSubject("验证码");
13
        message.setText("您的验证码是：123456");
14
        javaMailSender.send(message);
15
        return "ok";
16
    }
17
}

展开收起

使用 @Async 实现异步发送#

同步发送邮件会阻塞请求线程，高并发场景下推荐异步化。

1. 开启异步支持#

1
@SpringBootApplication
2
@EnableAsync
3
public class Application {
4
    public static void main(String[] args) {
5
        SpringApplication.run(Application.class, args);
6
    }
7
}

2. 异步发送服务#

1
@Component
2
@Slf4j
3
public class EmailService {
4

5
    @Autowired
6
    private JavaMailSender javaMailSender;
7

8
    @Autowired
9
    private StringRedisTemplate stringRedisTemplate;
10

11
    @Async
12
    public void sendVerificationCode(String email) {
13
        String code = UUID.randomUUID().toString().substring(0, 6);
14
        SimpleMailMessage message = new SimpleMailMessage();
15
        message.setFrom("your-name<your-email@example.com>");
16
        message.setTo(email);
17
        message.setSubject("验证码");
18
        message.setText(code);
19

20
        stringRedisTemplate.boundValueOps("code:" + email)
21
            .set(code, 5, TimeUnit.MINUTES);
22
        javaMailSender.send(message);
23
        log.info("Verification code sent to: {}", email);
24
    }
25
}

展开收起

3. 自定义线程池#

默认的异步线程池核心线程数为 8，可根据业务调整：

1
spring:
2
  task:
3
    execution:
4
      pool:
5
        core-size: 50

或通过 Java 配置：

1
@Bean
2
public ThreadPoolTaskExecutor threadPoolExecutor() {
3
    ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
4
    executor.setCorePoolSize(20);
5
    executor.setMaxPoolSize(50);
6
    executor.setQueueCapacity(200);
7
    executor.setThreadNamePrefix("mail-executor-");
8
    executor.initialize();
9
    return executor;
10
}

@Async 失效的常见原因#

使用 @Async 时，以下情况会导致注解失效：

方法不是 public 的
返回值不是 void 或 Future
方法使用 static 修饰
Spring 扫描不到类（缺少 @Component/@Service 等注解）
调用方与被调用方在同一个类中（Spring AOP 代理无法拦截内部调用）
通过 new 手动创建对象，而非依赖注入
在 @Async 方法上直接加 @Transactional 无效——应在被调用的方法上加

参考：https://blog.csdn.net/u011413452/article/details/124844941

SpringBoot 调用腾讯云 API 发送短信

Thu, 23 Jul 2026 00:00:00 GMT

SpringBoot 调用腾讯云 API 发送短信#

第一步：申请短信服务#

打开腾讯云控制台，申请短信应用、签名与模板。

第二步：API 调试#

在腾讯云 API Explorer 页面可以快速生成调用代码。

导入依赖#

1
<dependency>
2
    <groupId>com.tencentcloudapi</groupId>
3
    <artifactId>tencentcloud-sdk-java</artifactId>
4
    <version>3.1.838</version>
5
</dependency>

原始调用代码#

1
public class SendSms {
2
    public static void main(String[] args) {
3
        try {
4
            Credential cred = new Credential("SecretId", "SecretKey");
5
            HttpProfile httpProfile = new HttpProfile();
6
            httpProfile.setEndpoint("sms.tencentcloudapi.com");
7

8
            ClientProfile clientProfile = new ClientProfile();
9
            clientProfile.setHttpProfile(httpProfile);
10

11
            SmsClient client = new SmsClient(cred, "ap-beijing", clientProfile);
12

13
            SendSmsRequest req = new SendSmsRequest();
14
            String[] phoneNumberSet1 = {"your-phone-number"};
15
            req.setPhoneNumberSet(phoneNumberSet1);
16
            req.setSmsSdkAppId("1400849908");
17
            req.setSignName("your-sign-name");
18
            req.setTemplateId("1907520");
19

20
            String[] templateParamSet1 = {"6666"};
21
            req.setTemplateParamSet(templateParamSet1);
22

23
            SendSmsResponse resp = client.SendSms(req);
24
            System.out.println(SendSmsResponse.toJsonString(resp));
25
        } catch (TencentCloudSDKException e) {
26
            System.out.println(e.toString());
27
        }
28
    }
29
}

展开收起

返回结果示例：

1
{
2
  "SendStatusSet": [
3
    {
4
      "SerialNo": "3369:294906593316931104718082751",
5
      "PhoneNumber": "your-phone-number",
6
      "Fee": 1,
7
      "Code": "Ok",
8
      "Message": "send success",
9
      "IsoCode": "CN"
10
    }
11
  ],
12
  "RequestId": "69aceba9-a43d-434c-9021-e7320ef52d49"
13
}

第三步：封装为 Spring Boot 工具类#

1. 配置属性#

1
myapp:
2
  secretId: your-secret-id
3
  secretKey: your-secret-key
4
  smsSdkAppId: your-sdk-app-id
5
  signName: your-sign-name
6
  templateId: your-template-id

2. 配置属性绑定类#

1
@Component
2
@ConfigurationProperties(prefix = "myapp")
3
public class MyAppProperties {
4
    private String secretId;
5
    private String secretKey;
6
    private String smsSdkAppId;
7
    private String signName;
8
    private String templateId;
9

10
    // getters and setters
11
}

注意：set 方法不要写成 static 的，否则 @ConfigurationProperties 无法正常注入。

3. 发送短信工具类#

1
@Component
2
@Slf4j
3
public class SmsUtil {
4
    private static SmsClient client = null;
5

6
    @PostConstruct
7
    public void init() {
8
        client = createClient(
9
            MyAppProperties.getSecretId(),
10
            MyAppProperties.getSecretKey()
11
        );
12
    }
13

14
    public static void sendVerificationCode(String phone, String code) {
15
        SendSmsRequest req = new SendSmsRequest();
16
        req.setPhoneNumberSet(new String[]{phone});
17
        req.setSmsSdkAppId(MyAppProperties.getSmsSdkAppId());
18
        req.setSignName(MyAppProperties.getSignName());
19
        req.setTemplateId(MyAppProperties.getTemplateId());
20
        req.setTemplateParamSet(new String[]{code});
21

22
        try {
23
            SendSmsResponse resp = client.SendSms(req);
24
            log.info("SMS send result: {}", SendSmsResponse.toJsonString(resp));
25
        } catch (TencentCloudSDKException e) {
26
            log.error("Failed to send SMS", e);
27
            throw new RuntimeException(e);
28
        }
29
    }
30

31
    private static SmsClient createClient(String secretId, String secretKey) {
32
        Credential cred = new Credential(secretId, secretKey);
33
        HttpProfile httpProfile = new HttpProfile();
34
        httpProfile.setEndpoint("sms.tencentcloudapi.com");
35
        ClientProfile clientProfile = new ClientProfile();
36
        clientProfile.setHttpProfile(httpProfile);
37
        return new SmsClient(cred, "ap-beijing", clientProfile);
38
    }
39
}

展开收起

4. 对外接口#

1
@RestController
2
public class SmsController {
3
    @GetMapping("/sms")
4
    public String sendSms() {
5
        SmsUtil.sendVerificationCode("your-phone", "1234");
6
        return "ok";
7
    }
8
}

总结#

整个演进过程：API 调试（原生 SDK）→ 配置外置（ConfigurationProperties）→ 静态工具类封装（@PostConstruct 初始化）。日常开发中推荐直接使用封装后的工具类方式，避免在业务代码中重复编写 SDK 调用逻辑。