GzDyi's Blog

2025 Year in Review

Thu, 23 Jul 2026 00:00:00 GMT

2025 Year in Review#

Memory is like a glass of water, time like an open faucet — the water in the glass grows fainter with each passing day. Before I knew it, it was the end of 2025 again. I’d planned a mid-year review back in 2024, but procrastination got the better of me. Life settled into a comfort zone — work consumed most of my days under fluorescent office lights, blurring the line between day and night. What little free time I had, I wanted to spend outdoors with friends. Today is the fourth day of my sick leave from the flu, and I hope to capture some memorable and meaningful moments before the clarity that illness brings is washed away by the joy of recovery.

Work#

Work this year was steady — methodical, rigorous, improving technically, and striving for excellence. Compared to last year, the biggest change has been how AI tools have transformed coding. With major improvements in context awareness, agent capabilities, and automated search, the hottest trend right now is vibe coding — completing coding, debugging, and testing entirely through natural language conversations. This has freed up a lot of mental bandwidth, letting AI handle repetitive, predictable tasks perfectly. On the backend, complex logic still needs careful checking, but on the frontend, simply articulating your ideas clearly can often yield perfect results from AI in one pass.

While AI has dramatically boosted productivity, new tools always bring disruption. AI has leveled the playing field for experience to a large extent, without creating many new job opportunities. As an ordinary person riding this wave, the best approach is probably to embrace change as much as possible and build a financial cushion for the uncertainties ahead.

Learning#

This year’s learning was decent — I passed four exams in my self-study program. Not that I expect these credentials to be particularly useful, but they give me tangible milestones on my lifelong learning journey. Through exam preparation, I systematically revisited modern Chinese history and Marxist principles. While I only scratched the surface, I gained a lot. Marxist philosophy taught me to look at problems from a more abstract, higher-dimensional perspective, and modern Chinese history gave me a fresh understanding of the timeline and the role of key conferences.

I also learned about personal finance and savings, and my savings goals for the year are on track. My investments had ups and downs, but overall I’m in the green — though unrealized gains are just paper profits.

On learning methods: for unfamiliar domains, I now start with videos and beginner-friendly articles, saving books for in-depth reference and gap-filling. I try to apply the principle of negation of negation when encountering differing viewpoints.

Health#

Exercise this year was a mess — otherwise I wouldn’t have caught colds repeatedly within a month. After getting two impacted wisdom teeth pulled during summer break, I completely gave up on working out. My annual checkup showed various minor abnormalities — partly from poor diet, partly from staying up late. Living alone gives too much freedom, and the combination of constant air conditioning, lack of outdoor activity, and late-night doom-scrolling took its toll.

Improving my fitness will be a core priority for 2026: regular作息, creating a calorie deficit to lose weight, and disciplining my diet and exercise.

Books#

Money Money Money (Kira and the Kurrawong Club)#

When you set a big goal, you must put in much more effort than others.

A children’s book, but an excellent introduction for anyone completely new to personal finance. Following the methods in this book, I completed my savings plan two months ahead of schedule.

You Are What You Eat 2#

Don’t be extreme in your diet — eat a diverse mix of everything.

This book reinforced my belief that matter determines consciousness and consciousness acts on matter. I’ve been gaining weight since starting work, mainly because of prolonged sitting, slow metabolism, and the habit of treating myself after work. Lack of sunlight in the office leads to vitamin D deficiency and a weakened immune system.

MongoDB: Advanced Practices#

MongoDB’s indexing, storage engine, concurrency (MVCC), locking mechanism, and oplog design share many principles with MySQL.

You never miss knowledge until you need it. Taking time to fill gaps in my understanding made working with related documentation much smoother.

Zen and the Art of Motorcycle Maintenance#

When you’re in a hurry to get something done, it means you no longer care about it and want to do something else.

The book is about a motorcycle road trip and repairs, but the philosophy applies to all technical work. A deeply insightful read.

A Short History of Chinese Philosophy#

One must first speak many words, then remain silent.

I picked this up when I had ideological conflicts with my parents, hoping to understand why they think the way they do. Many of their ideas are deeply ingrained in their upbringing, and this book helped me connect the dots.

Games#

Aokana: Four Rhythm Across the Blue: Top-tier story and music across the board. All four heroines are exceptionally well-written. Appreciating art like this is a genuine pleasure.

Honor of Kings: I play a couple of matches every month or two as a lunch-break pastime. Ranking up too high brings out the try-hard mentality.

Delta Force: Hawk Ops: About 90 hours played. A great way to decompress on days off. No pay-to-win pressure, and bot matches make it easy to pick up.

At the end of the day, gaming is best when shared with friends.

Anime#

I watched quite a lot this year. I realized I don’t dislike anime — I’m just not into most new seasonal shows. Most of what I watched were older series.

Yamada-kun and the Seven Witches
The Rising of the Shield Hero
The Magical Revolution of the Reincarnated Princess and the Genius Young Lady
Classroom of the Elite Season 3
A Mortal’s Journey to Immortality
Shrouding the Heavens
Wandering Witch: The Journey of Elaina
The Eminence in Shadow
My Teen Romantic Comedy SNAFU (rewatch)
Knight’s & Magic (rewatch)
That Time I Got Reincarnated as a Slime
Onimai: I’m Now Your Sister! (rewatch)
Uncle from Another World
Puella Magi Madoka Magica series

Movies#

Detective Conan: Crossroad in the Ancient Capital
Nezha: The Devil’s Child Stirs Up the Sea
Malignant
Detective Conan: The Afterimage of a Single Eye
Final Destination: Bloodlines
Dream Cure
Operation蛟龙
Demon Slayer: Infinity Castle
Zootopia 2
Scent of a Woman
Detective Chinatown 1900
Under the Haze (play at Luojia Mountain Theater)
Happy Dinner (play at Hubei Theater)

Travel#

The more you go out, the more you suffer along the way — but the novelty you encounter on the road is something you’ll never experience close to home.

Mount Lu, Jiangxi: I went during the off-season when it was free. The sun was warm at the foot of the mountain, but the summit was covered in snow. The ice on the steps forced us to walk on tiptoe. Unfortunately, the trip was rushed — after climbing the Five Old Men Peak, we were too exhausted to reach the Three Fold Spring.

Changsha, Hunan: I took an overnight green-train after work. The smell of feet and smoke on the train is still unforgettable. My second visit to Changsha opened a whole new door — I experienced what nightlife really means: 24-hour hotpot restaurants, 24-hour Mixue ice cream shops. This time I made it to the top of Yuelu Mountain, which I’d missed before. The mountain breeze and the panoramic view of downtown Changsha were unmatched.

Tiantangzhai (Heavenly Village), Anhui: I went during National Day. On the way up, the road disappeared into thick clouds with terrible visibility and rain. Then, after passing through a tunnel, the sky suddenly cleared. The walkways were built along cliff faces, swaying with the crowds — quite scary. The air at the summit was the freshest I’ve ever breathed. The cable car ride down was a bit too thrilling for someone who’d just read about cable car mechanics two days earlier.

Request Wildcard SSL Certificates with acme.sh

Thu, 23 Jul 2026 00:00:00 GMT

Request Wildcard SSL Certificates with acme.sh#

Let’s Encrypt provides free wildcard certificates. Combined with the acme.sh script, you can fully automate issuance and renewal — perfect for personal sites.

Install acme.sh#

Terminal window

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

Issue a Certificate (Cloudflare DNS API)#

1. Get Your Cloudflare API Key#

2. Configure the API Key#

Terminal window

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

3. Issue the Wildcard Certificate#

Terminal window

1
# Replace with your domain
2
./acme.sh --issue --dns dns_cf -d example.com -d *.example.com

4. Verification#

The certificate will be installed to ~/.acme.sh/. Check the auto-renewal cron job:

Terminal window

1
crontab -l

acme.sh automatically adds a scheduled task for renewal before expiration.

Working with Nginx Proxy Manager#

Copy the generated certificate files to NPM’s directory, or upload them manually through NPM’s web interface.

Notes#

Alibaba Cloud DNS, Tencent Cloud DNS, etc., also have their own DNS API scripts available in the acme.sh official repository
Wildcard certificates only support DNS verification, not HTTP
Certificates are valid for 90 days; acme.sh handles renewal automatically

References#

Docker Image and Container Export/Import Commands Explained

Thu, 23 Jul 2026 00:00:00 GMT

Docker Image and Container Export/Import Commands Explained#

Docker provides several commands for exporting and importing images and containers, which can be confusing for beginners. This article breaks down the key differences.

docker export / docker import#

These operate on containers and export a snapshot of the container’s current filesystem.

Terminal window

1
# Export container snapshot
2
docker export container-id > snapshot.tar
3

4
# Import as an image
5
docker import snapshot.tar new-image-name:tag

Characteristics:

Only retains filesystem changes made from container start to export — discards history layers and metadata
Smaller file size (single filesystem layer)
Must specify a new image name and tag on import
Imported images require /bin/bash or another entrypoint on start

Use case: Creating base images. For example, start a container from ubuntu, install software, then export it as a distributable base image.

docker commit#

Operates on containers, saving modifications as a new image.

Terminal window

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

Common options:

-a: Author information
-m: Commit message
-p: Pause the container during commit

Characteristics:

Preserves the container’s writable layer plus the original image’s history layers
An N-layer image becomes N+1 layers after commit
Retains metadata like the entrypoint command

Use case: Quickly save changes from a debugging environment to create a reusable image.

docker save / docker load#

Operate on images, exporting the complete layer structure.

Terminal window

1
# Save an image
2
docker save -o image.tar image-name:tag
3

4
# Load an image
5
docker load -i image.tar

Characteristics:

Preserves the full layer structure and metadata
Larger file size than export (includes all history layers)
load cannot rename the image, while import can assign a new name

Use case: Offline image migration. On a server without internet, pull the image on a connected machine, save it, copy the archive, then load it on the target server.

Comparison Summary#

Command	Target	History Layers	File Size	Rename on Import
`docker export`	Container	❌ Single layer only	Small	✅
`docker commit`	Container	✅ Adds one layer	Medium	✅
`docker save`	Image	✅ Full preservation	Large	❌
`docker load`	Image	✅ Full preservation	Large	❌
`docker import`	Snapshot file	❌ Single layer only	Small	✅

Quick memory aid: save/load work with images, export/import work with containers, and commit is the bridge from container → image.

Deploy a Nacos Cluster with Docker

Thu, 23 Jul 2026 00:00:00 GMT

Deploy a Nacos Cluster with Docker#

Pull the Image#

Terminal window

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

Avoid pulling the latest tag — always pin a specific version for production.

Database Setup#

Nacos cluster requires MySQL to store configuration data. MySQL 5.7 is recommended.

Create a database named nacos_config and run the official initialization script (located in the Nacos source at distribution/conf/nacos-mysql.sql, which creates config_info, config_info_aggr, users, roles, and other core tables).

Create Nacos Containers#

Create three Nacos instances to form the cluster. Replace IP addresses in the commands below with your server’s IP.

Node 1 (Port 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

展开收起

Node 2 (Port 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

展开收起

Node 3 (Port 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

展开收起

Verify the Cluster#

Visit http://ip:port/nacos on any node. The default credentials are nacos/nacos. You should see all three nodes listed in the Cluster Management page.

Nginx Load Balancing#

Configure the Upstream#

Create a custom configuration in your Nginx Proxy Manager installation directory:

/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
}

Configure the Reverse Proxy#

Add a proxy in NPM’s web interface:

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

Then add this in the Advanced tab:

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

After configuring an SSL certificate, you can access the Nacos console at https://nacos.your-domain.com/nacos.

Note: When using Nginx Proxy Manager, create http.conf under the nginx/custom/ directory in the container mount. NPM will automatically include this file in the global configuration.

References#

Switch Java (JDK) Versions Freely with Scoop

Thu, 23 Jul 2026 00:00:00 GMT

Switch Java (JDK) Versions Freely with Scoop#

In daily development, you often need to switch between different JDK versions like Java 8, Java 11, Java 17, or Java 21. Manual uninstallation and cleanup of registry entries is painful. Scoop makes this effortless.

Install Scoop#

Open PowerShell and run:

Terminal window

1
# Allow local script execution
2
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
3

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

7
# Verify installation
8
scoop help

Install Multiple JDK Versions#

1. Add the Java Bucket#

Terminal window

1
scoop bucket add java

2. List Available JDK Versions#

Terminal window

1
scoop search jdk

3. Install Different Versions#

Terminal window

1
# Install OpenJDK 8
2
scoop install openjdk8-redhat
3

4
# Install OpenJDK 21
5
scoop install openjdk21

4. Switch JDK Versions#

Terminal window

1
# Switch to JDK 8
2
scoop reset openjdk8-redhat
3

4
# Switch to JDK 21
5
scoop reset openjdk21
6

7
# Switch to GraalVM 21
8
scoop reset graalvm21-jdk21

If you previously installed JDK manually, consider removing the system JAVA_HOME environment variable — Scoop manages user-level JAVA_HOME automatically.

How It Works#

scoop reset updates the user’s JAVA_HOME and PATH environment variables to point to the selected JDK directory. Changes take effect immediately in new terminal windows — no restart needed.

Similarly, Python, Ruby, Node.js, and other runtimes can be managed with Scoop for effortless version switching.

Server Initialization Guide

Thu, 23 Jul 2026 00:00:00 GMT

Server Initialization Guide#

1. System Update#

Terminal window

1
apt update
2
apt upgrade -y

2. Security Hardening#

Change the SSH Port#

Edit the SSH config file /etc/ssh/sshd_config and change the default port 22:

Terminal window

1
vim /etc/ssh/sshd_config
2
# Find #Port 22, change to Port your-port
3
# Save and restart the service
4
systemctl restart ssh

Create a Non-root User#

Terminal window

1
# Create a new user
2
adduser your-username
3

4
# Install sudo
5
apt install sudo
6

7
# Add the user to the sudo group
8
usermod -aG sudo your-username
9

10
# Or edit /etc/sudoers to add:
11
# your-username ALL=(ALL) NOPASSWD: ALL

Disable Root Remote Login#

Terminal window

1
# In /etc/ssh/sshd_config, set:
2
PermitRootLogin no

SSH Key Authentication + Disable Passwords#

Terminal window

1
# Generate a key pair locally, then copy the public key to the server
2
ssh-copy-id your-username@your-server-ip
3

4
# In /etc/ssh/sshd_config:
5
PasswordAuthentication no
6
PubkeyAuthentication yes
7

8
# Restart the service
9
sudo systemctl restart ssh

3. Install Common Software#

Docker#

Refer to the official Docker documentation for installation.

Nginx Proxy Manager#

Install NPM via Docker for a web UI to manage reverse proxies and SSL certificates.

SSL Certificates#

Use acme.sh + Cloudflare DNS API to issue wildcard certificates with auto-renewal.

Internal Network Tunneling (frp)#

Use frp for internal network tunneling. Newer versions use TOML configuration.

Alist#

Multi-storage mounting tool with one-click Docker deployment. See Alist documentation for details.

Firewall#

Remember to allow the new SSH port in the firewall
Use iptables to mitigate SYN and CC attacks
Only expose necessary ports (80, 443, SSH, etc.)

SpringBoot Email Sending with @Async Optimization

Thu, 23 Jul 2026 00:00:00 GMT

SpringBoot Email Sending with @Async Optimization#

Basic Configuration#

1. Add the Dependency#

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

2. Configure Mail Properties#

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

The password field requires an authorization code, not your email login password. For 163 mail, enable POP3/SMTP/IMAP in settings and generate an auth code.

3. Send a Simple Email#

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("Verification Code");
13
        message.setText("Your code is: 123456");
14
        javaMailSender.send(message);
15
        return "ok";
16
    }
17
}

展开收起

Async Sending with @Async#

Synchronous email sending blocks the request thread. For high-concurrency scenarios, async is recommended.

1. Enable Async Support#

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

2. Async Email Service#

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("Verification Code");
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. Custom Thread Pool#

The default async thread pool has a core pool size of 8. Adjust it as needed:

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

Or via Java configuration:

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
}

Common @Async Pitfalls#

@Async won’t work in these cases:

The method is not public
Return type is not void or Future
The method is static
Spring cannot scan the class (missing @Component/@Service etc.)
Caller and callee are in the same class — Spring AOP proxies can’t intercept internal calls
Creating the object with new instead of dependency injection
Adding @Transactional directly on an @Async method — put @Transactional on the called method instead

Reference: https://blog.csdn.net/u011413452/article/details/124844941

Send SMS via Tencent Cloud API with Spring Boot

Thu, 23 Jul 2026 00:00:00 GMT

Send SMS via Tencent Cloud API with Spring Boot#

Step 1: Apply for SMS Service#

Open the Tencent Cloud console, apply for an SMS application, signature, and template.

Step 2: API Debugging#

You can quickly generate calling code on the Tencent Cloud API Explorer page.

Add the Dependency#

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

Raw Calling Code#

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
}

展开收起

Example response:

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
}

Step 3: Wrap as a Spring Boot Utility#

1. Configuration Properties#

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. Configuration Binding Class#

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
}

Note: Don’t make set methods static, or @ConfigurationProperties won’t inject values properly.

3. SMS Utility Class#

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. API Endpoint#

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

Summary#

The evolution: API debugging (raw SDK) → externalized configuration (ConfigurationProperties) → static utility class (@PostConstruct initialization). In daily development, the wrapped utility class approach is recommended to avoid duplicating SDK calling logic across business code.