基于 Spring Boot 与 AES 实现接口响应数据加密

前言

最近项目中为了保证数据安全，要求接口对关键响应数据，比如敏感信息（如用户信息、权限数据、业务关键内容等）必须加密传输，若以明文形式返回，极易被中间人窃取或篡改，造成用户隐私泄露与系统安全风险。

所以，本文将围绕一个实际的 Spring Boot 应用场景，基于 ​​Hutool 工具包中的 AES 加密能力​ ​，封装一个 ​​接口响应数据自动加密的解决方案​​，欢迎大家在评论区进行讨论。

---

一、背景与问题分析

在现有的项目中有两个接口：

• ​/getInfo 接口​ ：模拟查询用户信息，构造了一个 JSON 字符串，然后使用 AES 加密，并将加密后的 ​Base64 密文​ 直接作为接口返回值。
• ​/decrypt 接口​：提供一个解密入口，接收 Base64 密文，调用 AES 解密并返回明文，主要用于测试和验证。

因此，需要一种 ​​统一、自动、可扩展的响应加密机制​ ​，让指定的接口或全局的响应数据，在返回给前端之前，​​自动完成 AES 加密处理，返回密文（Base64 格式）​​，从而提升接口数据的安全性，同时降低重复劳动。

---

二、实现 Spring Boot 接口响应自动加密

​​封装一个统一机制，对 Spring Boot 接口的返回结果（如 Result 对象或 JSON 数据）在返回给客户端之前，自动进行 AES 加密，并返回密文的 Base64 字符串，保障敏感数据传输安全。​​

---

1. ​​加密工具：Hutool 的 SecureUtil.aes​​

Hutool 是一个 Java 工具库，其中的 SecureUtil.aes(key)提供了 ​​AES 加密 / 解密​​ 的简便方法，支持：

• AES 加密为字节数组或 Base64 字符串
• 支持传入固定字节数组密钥
• 默认使用安全的填充与模式（如 PKCS5Padding / ECB 或 CBC，取决于构造方式）

---

2. ​​统一响应加密方案：使用 Spring AOP 或 ResponseBodyAdvice​​

接下来就是处理接口， 本次使用 ​​ResponseBodyAdvice ​​（Spring 提供的统一响应体拦截机制）

---

3.定义一个注解

本次项目由于只对用户信息相关接口进行加密，可以定义一个自定义注解，对需要的接口进行处理，如：

import java.lang.annotation.*;

@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface EncryptResponse {
}

接下来就可以，在需要加密的 Controller 方法或类上加上该注解：

@EncryptResponse
@RequestMapping("/getInfo")
public Result info(String uid) {
    // 模拟查询数据 
    String json = "{"uid":"" + uid + "","name":"testUser","pwd":"123456"}"; 
    // 使用AES加密并返回Base64编码的结果 
    String encryptedData = SecureUtil.aes(aesKey).encryptBase64(json); return Result.ok(encryptedData);

}

---

4.实现 ResponseBodyAdvice 接口，统一处理加密逻辑

接下来就是，处理控制器统一加密响应操作，创建一个类：AESResponseEncryptAdvice.java

import cn.hutool.core.codec.Base64;
import cn.hutool.crypto.SecureUtil;
import com.qiming.common.utils.Result;
import org.springframework.core.MethodParameter;
import org.springframework.http.MediaType;
import org.springframework.http.converter.HttpMessageConverter;
import org.springframework.http.server.ServerHttpRequest;
import org.springframework.http.server.ServerHttpResponse;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import org.springframework.web.servlet.mvc.method.annotation.ResponseBodyAdvice;

@RestControllerAdvice
public class AESResponseEncryptAdvice implements ResponseBodyAdvice<Object> {

    // 与加密工具类中一致的 AES 密钥（Base64 解码）
    private static final byte[] AES_KEY = Base64.decode("ew7UkDs58QfulRGXD24R8A==");

    @Override
    public boolean supports(MethodParameter returnType, Class<? extends HttpMessageConverter<?>> converterType) {
        // 若想全局加密，直接返回 true
        return true;
    }

    @Override
    public Object beforeBodyWrite(Object body, MethodParameter returnType,
                                  MediaType selectedContentType,
                                  Class<? extends HttpMessageConverter<?>> selectedConverterType,
                                  ServerHttpRequest request, ServerHttpResponse response) {

        // 仅处理 Result 类型（或你自定义的统一返回类型），或 JSON 响应
        if (body instanceof Result) {
            Result result = (Result) body;

            // 只有成功响应，且需要加密时才加密 data 字段（可根据需求调整）
            if (result.isSuccess()) {
                try {
                    // 将整个返回的 data 部分（通常是 JSON 字符串或对象）进行加密
                    // 这里简单起见，直接将整个 Result 转为 JSON 字符串然后加密
                    String originalJson = JsonUtil.toJson(result); 
                    String encrypted = SecureUtil.aes(AES_KEY).encryptBase64(originalJson);
                    // 返回一个特殊结构，或者直接返回加密后的密文
                    return Result.ok(encrypted);
                } catch (Exception e) {
                    e.printStackTrace();
                    return Result.fail("响应加密失败");
                }
            }
        }

        // 非加密接口，直接返回原数据
        return body;
    }
}

启动服务，调用获取用户信息接口，可以看到接口响应base64加密处理过的数据，而不是明文展示，至此就实现接口响应加密处理。

结语

通过对 Spring Boot 的 ​​ResponseBodyAdvice​ ​ 机制的合理利用，结合 ​​Hutool 提供的 AES 加密能力​ ​，可以非常便捷地实现对 API 响应数据的 ​​自动加密处理​​，有效提升数据传输的安全性，防止敏感信息泄露，同时对现有项目改动也不大。

---