CharacterCodingException是运行时异常，不能直接捕获；实际应捕获其子类MalformedInputException（输入字节非法）或UnmappableCharacterException（字符不可映射），二者均继承自IOException，推荐统一捕获IOException以覆盖所有编解码失败场景。
Java 中编码转换异常主要指 CharacterCodingException 及其子类（如 MalformedInputException、UnmappableCharacterException），还有受检的 UnsupportedEncodingException。它们不是流程控制工具，而是真实的数据兼容性问题信号，必须明确区分场景、精准捕获、有据处理。
明确区分两类异常：受检 vs 运行时
这两类异常的处理逻辑完全不同，不能混用一套策略：
-
UnsupportedEncodingException 是受检异常，只在显式指定编码名字符串（如
"GBK"）且该名称不被 JVM 支持时抛出。它发生在编码器初始化阶段，比如调用String.getBytes("xxx")或new InputStreamReader(in, "xxx")时。 -
CharacterCodingException 是运行时异常，发生在实际字节与字符双向转换过程中，比如
CharsetDecoder.decode()遇到非法 UTF-8 序列，或CharsetEncoder.encode()遇到无法映射的 Unicode 字符。它不依赖编码名是否合法，而取决于输入数据本身是否符合目标编码规则。
按场景选择捕获方式
捕获不是目的，匹配上下文才是关键：
- 对
UnsupportedEncodingException：优先避免硬编码字符串。使用StandardCharsets.UTF_8等标准常量；若必须动态传入编码名，先用Charset.isSupported(name)校验，校验失败则走降级逻辑（如默认用 UTF-8），而非依赖 catch。 - 对
CharacterCodingException：必须用具体子类捕获，不能只 catch 父类。例如：- 捕获
MalformedInputException表示输入字节序列本身非法（如截断的 UTF-8）； - 捕获
UnmappableCharacterException表示字节可解析，但对应字符在目标编码中无映射（如 UTF-8 字符转 GBK 时含生僻字）； - 两者都发生时，应记录原始字节、偏移位置和编码名称，便于定位脏数据来源。
- 捕获
处理动作要具业务含义，不吞不裸奔
捕获后必须给出明确响应，禁止空 catch 或仅打印堆栈：
立即学习“Java免费学习笔记（深入）”；
- 对文件/网络输入流解码失败：可跳过当前数据块、标记为“编码异常”并记录原始二进制快照，供后续人工核查；
- 对用户提交内容（如表单）解码失败：返回友好提示（如“内容包含不支持的字符，请改用常用汉字或英文”），同时记录日志含请求 ID 和原始字节；
- 对内部系统间通信：建议统一使用 UTF-8，若对方强制用其他编码，应在协议层约定容错策略（如替换为 或丢弃不可映射字符），并在
CharsetDecoder中设置onUnmappableCharacter(CodingErrorAction.REPLACE)等策略，把异常拦截在转换前。
预防优于捕获，从源头控编码一致性
多数编码异常其实可提前规避：
- 所有 I/O 操作（文件读写、HTTP 请求/响应、数据库字段）务必在文档或配置中明确定义编码，开发、测试、生产环境保持一致；
- 使用
InputStreamReader/OutputStreamWriter时，始终传入Charset对象（如StandardCharsets.UTF_8），而非字符串，避免触发UnsupportedEncodingException； - 对不确定来源的字节流，可先用
CharsetDetector（如 ICU4J）做启发式检测，再决定解码方式，而不是盲目尝试多个编码。
