Base64 URL安全解码不能直接用 java.util.Base64.getDecoder()
它默认只支持标准 Base64（RFC 4648 §4），遇到 URL 安全变体（RFC 4648 §5）会抛 IllegalArgumentException: Illegal base64 character。URL 安全编码把 + 换成 -、/ 换成 _，还可能省略填充 =——getDecoder() 不认这些。
必须用 Base64.getUrlDecoder() 才行
这是 JDK 8+ 提供的专用解码器，内部已处理字符映射和填充容错：
- 接受
-和_替代+// - 允许末尾缺失
=（自动补足） - 拒绝含非法字符（如空格、换行）的输入，不静默忽略
示例：
String encoded = "dGVzdA"; // "test" 的 URL 安全编码（无填充） byte[] decoded = Base64.getUrlDecoder().decode(encoded); // ✅ 成功
别混用 getUrlEncoder() 和 getDecoder()
URL 安全编码/解码必须配对使用。常见错误：
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
立即学习“Java免费学习笔记（深入）”；
- 用
Base64.getEncoder().encodeToString(...)编码，再用getUrlDecoder()解码 → 可能失败（标准编码含+//） - 用
getUrlEncoder()编码，却用getDecoder()解码 → 报错（-/_被当非法字符）
记住：URL 场景下，编码和解码两端都得走 getUrlXxx() 系列。
注意 JDK 版本和空值处理
getUrlDecoder() 是 JDK 8 引入的，JDK 7 及更早版本没有。如果必须兼容旧版，得自己替换字符再调 getDecoder()，但要注意：
- 手动替换
-→+、_→/后，还得补足=（长度需是 4 的倍数） -
getUrlDecoder().decode(null)会抛NullPointerException，生产代码要先判空 - 某些前端库（如 JavaScript
btoa()）不生成 URL 安全编码，后端收到时得先确认来源规范
Illegal base64 character 里。 
