AES加密结果含特殊字符致URL传输异常的解决方案问询

方案1：使用URL安全的Base64编码 #

标准Base64生成的+、/、=属于URL保留字符，直接放在路径中会被解析为路径分隔符或引发格式错误。Java提供了URL安全的Base64变体，将+替换为-，/替换为_，还可选择去掉末尾的=填充符，完全适配URL场景。

工具类修改示例： #

在你的EncryptUtil中，替换所有标准Base64编码/解码逻辑为URL安全版本：

// 加密时使用URL安全Base64（去掉填充符）
return Base64.getUrlEncoder().withoutPadding().encodeToString(cipherText);

// 解密时对应使用URL安全Base64解码
byte[] plainText = cipher.doFinal(Base64.getUrlDecoder().decode(cipherText));

注意：withoutPadding()不会影响解码，因为AES加密后的字节长度是16的整数倍，Base64解码时可自动识别缺失的填充。前后端需统一使用该编码规则。

方案2：对加密结果做URL转义编码 #

如果不想修改Base64编码方式，可在生成URL前对加密后的字符串做URL转义，将特殊字符替换为%xx格式：

• URL生成端：使用URLEncoder.encode(encryptedStr, "UTF-8")，将+转为%2B，/转为%2F，=转为%3D
• Quarkus后端：框架会自动解码路径参数，若需手动处理可使用URLDecoder.decode(param, "UTF-8")

注意：部分Kubernetes Ingress控制器可能需要配置允许转义字符，可检查Ingress规则的相关注解，确保转义后的参数能正常传递。

方案3：调整参数传递方式（路径→查询参数） #

将加密参数从路径参数改为查询参数，URL格式改为：
https://10.162.128.94:30000/userProfile/v3.6/users?encrypted=WKqxB/qNPQUz6wRbHZrpBQ==
Quarkus中通过@QueryParam("encrypted") String encryptedParam接收即可。查询参数对特殊字符的兼容性更好，Ingress和网关对其解析逻辑更成熟，不易引发路径识别异常。

内容的提问来源于stack exchange，提问作者Cesar Justo