敏感信息如何安全传输：Alipay SDK for Java AES 加解密机制完整指南

敏感信息如何安全传输：Alipay SDK for Java AES 加解密机制完整指南

【免费下载链接】alipay-sdk-java-all支付宝开放平台 Alipay SDK for Java项目地址: https://gitcode.com/gh_mirrors/al/alipay-sdk-java-all

Alipay SDK for Java（支付宝开放平台 Java 开发工具包）内置了AES 字段加解密能力：当调用涉及姓名、证件号、手机号等敏感信息的接口时，SDK 会自动把biz_content用 AES 对称加密后再发送，并在收到响应时自动解密还原，帮助开发者安全传输敏感数据。

一、为什么敏感字段必须加密？

调用支付宝开放平台时，两类"安全"经常一起出现，新手容易混淆：

签名保证的是完整性与身份，但它不隐藏内容。如果请求体里带着用户的证件号、姓名，仅靠签名，这些字段在链路日志、抓包中依然是明文。AES 字段加密正是为"内容保密"而生的：加密算法对双方对称，商户用平台下发的encryptKey加密，支付宝用同一把密钥解密，敏感数据在传输中始终密文状态。

配置入口集中在 AlipayConfig.java：

• encryptType：敏感信息对称加密算法类型，推荐AES；
• encryptKey：敏感信息对称加密算法密钥（16 位 Base64 字符串）。

二、完整流程：SDK 替你做了什么

整个过程无需你手动加解密，SDK 在 DefaultAlipayClient.java 初始化时就已装配好Encryptor与Decryptor两个组件：

商户侧（发送前） 支付宝网关 biz_content 明文 JSON ──AES加密──▶ biz_content 密文 ──▶ 签名 ──▶ HTTPS 发送 │ 响应 JSON 中 rsp 为密文 ◀────────────────────────────────────────┘ biz_content 密文 ──AES解密──▶ biz_content 明文 ──▶ 验签 ──▶ 解析为 Response 对象

关键逻辑在 AbstractAlipayClient.java：

1. 组装biz_content明文；
2. 判断request.isNeedEncrypt()——只有接口声明需要加密的请求才会走加密分支（例如证件查询类接口）；
3. 校验encryptType与加密器是否已配置，未配置直接抛出明确异常；
4. 用 AES 加密biz_content，然后再进行签名——即签名针对的是密文，加密针对的是内容，二者互不干扰。

响应侧由decryptResponse方法处理（见 AbstractAlipayClient.java）：同样是先判断isNeedEncrypt()，需要加密的接口才会调用解密器还原响应中的密文字段，最后交给解析器生成 Response 对象。

三、加解密核心类：DefaultEncryptor 与 DefaultDecryptor

SDK 采用"接口 + 默认实现"的设计，方便你后续扩展：

• 接口定义：Encryptor.java、Decryptor.java
• 默认实现：DefaultEncryptor.java、DefaultDecryptor.java

两个默认实现内部都委托给统一的加密门面 AlipayEncrypt.java，它维护了一个"算法名 → 实现类"的注册表：

四、AES 与 AES_V2 的区别：随机 IV 带来的安全升级

这是最值得新手理解的一个细节。🔐

AES（V1）：使用固定的全 0 初始向量（IV）。简单高效，但同一段明文每次加密结果相同，密文存在"可被比对"的理论风险。

AES_V2：每次加密都通过SecureRandom生成随机 IV，并把IV 拼在密文最前面再一起 Base64 编码输出（见 AesEncryptV2.java）。解密时先截取前 16 字节作为 IV，再还原明文。

V1 密文结构： Base64( 密文 ) V2 密文结构： Base64( 随机IV[16字节] + 密文 )

如何选择？遵循支付宝开放平台对应接口的要求——新接入且文档标注 AES_V2 的接口，就在配置中设置encryptType = "AES_V2"；老接口通常仍使用AES。两者密钥（encryptKey）通用。

五、最快配置方法：3 行代码开启加密

在 v2/README.md 的快速开始基础上，只需给AlipayConfig追加两个字段：

AlipayConfig config = new AlipayConfig(); config.setServerUrl("https://openapi.alipay.com/gateway.do"); config.setAppId("你的AppId"); config.setPrivateKey("你的应用私钥"); // 下面两行即开启 AES 字段加密 config.setEncryptType("AES"); config.setEncryptKey("开放平台下发的16位AES密钥"); AlipayClient client = new DefaultAlipayClient(config);

也可以用 Builder 链式风格（见 DefaultAlipayClient.java）：

AlipayClient client = DefaultAlipayClient.builder(serverUrl, appId, privateKey) .encryptType("AES") .encryptKey("16位AES密钥") .build();

配置完成后，无需再写任何加解密代码——SDK 根据每个接口是否标记了"需要加密"自动处理。想单独验证加解密能力，可以参考 EncryptTest.java。

六、新手常见错误排查清单

七、安全实践建议

• 🗝️密钥不要硬编码：encryptKey建议放入配置中心或环境变量，避免提交到代码仓库；
• 📡传输层叠加 HTTPS：AES 字段加密保护内容，HTTPS 保护整条链路，二者缺一不可，SDK 默认serverUrl即为https://；
• ✅签名不能省：加密 + 签名是组合拳，signType推荐 RSA2，切勿只加密不签名；
• 🔁跟随接口文档选算法：老接口用AES，新接口优先AES_V2（随机 IV 更安全），国密场景用SM4；
• 🧪上线前自检：用沙箱环境（https://openapi.alipaydev.com/gateway.do）跑一遍加密接口，确认收发双方密钥一致。

小结

Alipay SDK for Java 把 AES 字段加解密封装成了"配置即用"的能力：AlipayConfig里设置好encryptType和encryptKey，SDK 就会在发请求前自动加密biz_content、收到响应后自动解密，并与 RSA2 签名协同工作，让敏感信息在传输全程保持密文。理解AES与AES_V2的 IV 差异、牢记"加密保内容、签名保完整"的分工，你就能放心地把用户敏感数据交给支付宝开放平台处理。

【免费下载链接】alipay-sdk-java-all支付宝开放平台 Alipay SDK for Java项目地址: https://gitcode.com/gh_mirrors/al/alipay-sdk-java-all