springboot3 阿里云短信

### 如何在 Spring Boot 3 中配置和使用阿里云短信服务

#### 添加依赖项
为了简化集成过程并减少配置工作，可以在 `pom.xml` 文件中添加必要的 Maven 依赖项。这使得开发者能够专注于业务逻辑而非繁琐的设置。

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>4.5.0</version>
</dependency>
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-dysmsapi</artifactId>
    <version>1.1.0</version>
</dependency>

这些依赖允许应用程序轻松访问阿里云提供的 API 接口[^1]。

#### 配置文件修改
接着，在项目的 `application.yml` 或者 `application.properties` 文件内加入如下所示的相关属性：

对于 YAML 格式的配置文件：

aliyun:
  accessKeyId: your-access-key-id
  secretAccessKey: your-secret-access-key
  regionId: cn-hangzhou
sms:
  signName: YourSignName
  templateCode: SMS_YourTemplateCode
server:
  port: 8080

上述配置指定了连接到阿里云所需的身份验证信息以及默认发送短消息时所使用的签名名称与模板编号。

#### 创建 Service 类处理具体业务逻辑
定义一个新的 Java 类作为服务层组件，负责封装实际向用户提供验证码等功能的方法实现细节。这里给出一个简单的例子说明如何构建这样一个类：

@Service
public class MsmServiceImpl implements MsmService {

    @Value("${aliyun.accessKeyId}")
    private String accessKeyId;

    @Value("${aliyun.secretAccessKey}")
    private String secretAccessKey;
    
    // ... other properties ...

    @Override
    public String msmCode(String phoneNumber){
        DefaultProfile profile = DefaultProfile.getProfile("cn-hangzhou",accessKeyId,secretAccessKey);
        IAcsClient client = new DefaultAcsClient(profile);

        SendSmsRequest request = new SendSmsRequest();
        request.setPhoneNumbers(phoneNumber);
        request.setSignName(signName);
        request.setTemplateCode(templateCode);
        
        try {
            SendSmsResponse response = client.getAcsResponse(request);
            return "Success";
        } catch (Exception e) {
            throw new RuntimeException(e.getMessage());
        }
    }
}

这段代码展示了怎样利用 SDK 提供的功能完成一次完整的短信发送操作，并且捕获可能发生的异常情况以便后续调试分析。

#### 构建 Controller 层接口暴露给外部调用方
最后一步就是编写 RESTful Web Services 来接收来自客户端发起的 HTTP 请求并将它们转发至相应的处理器函数上执行特定的任务。下面是一个典型的控制器实例化方式及其路径映射规则设定：

@RestController
@RequestMapping("/msm")
public class MsmController {

    @Autowired
    private MsmService msmService;

    @GetMapping("/{phone}")
    public ResponseEntity<Map<String,Object>> sendVerificationCode(@PathVariable String phone){
        Map<String,Object> resultMap=new HashMap<>();
        String result=msmService.msmCode(phone);
        resultMap.put("status","success");
        resultMap.put("message",result);
        return ResponseEntity.ok(resultMap);
    }
}

此部分实现了 GET 方法用于触发手机验证流程并向用户返回状态报告[^3]。