CharsetEncoder与CharsetDecoder是为流式编解码设计的底层控制器，需用ByteBuffer管理状态（如UTF-8未完成序列），必须flip()后读取，转byte[]应flip()后array().clone()，且须遵循reset→encode/decode→flush标准流程。
Java NIO 中的 CharsetEncoder 和 CharsetDecoder 不是“字符串转字节数组”的快捷工具，而是为真实流式场景设计的底层编解码控制器——它们能分块处理、保持状态、响应错误，适合网络报文、日志流、内存受限环境等连续数据处理。
为什么必须用 ByteBuffer 而不是 byte[]？
编码/解码过程可能跨多次调用：比如 UTF-8 遇到一个未完成的三字节序列（如只读到前两个字节），或代理对（surrogate pair）处于中间状态。这些都需要内部状态记忆，而 ByteBuffer 的 position、limit、remaining() 等游标机制天然支持这种流式控制。
- encode() 后 buffer.position 指向已写入末尾，limit 仍为容量上限 → 必须调用
flip()才能从头读取有效数据 - 想转成
byte[]：先flip()，再用buffer.array().clone()（避免返回原始数组中带前导未用字节） - 不要复用同一 ByteBuffer 多次 encode()，除非显式
clear()；更稳妥做法是每次 allocate 新缓冲区
如何正确使用 encode() 和 decode()
标准流程是 reset → 操作 → flush，尤其在分块处理时不能省略 flush()，否则末尾残留字符可能被丢弃。
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 编码：调用
encoder.encode(charBuffer, byteBuffer, endOfInput)，endOfInput 为 true 表示输入结束，需后续调用flush() - 解码：调用
decoder.decode(byteBuffer, charBuffer, endOfInput)，同样需在最后flush()提取剩余字符 - 每次操作后检查
CoderResult：isUnderflow 表示输入不足，isOverflow 表示输出缓冲区满，isError 表示格式或映射错误
怎么处理非法字节或不可映射字符？
默认行为是抛异常（MalformedInputException 或 UnmappableCharacterException），但生产环境通常需要容错：
立即学习“Java免费学习笔记（深入）”；
- 设置错误策略：
decoder.onMalformedInput(REPLACE).onUnmappableCharacter(REPLACE) - 自定义替换内容：
decoder.replaceWith("")或encoder.replaceWith(new byte[]{(byte)0x3F}) - 调试阶段建议先用
REPORT模式跑样本，确认坏数据比例，再切到REPLACE
UTF-8 的 BOM 是个陷阱
Charset.forName("UTF-8") 返回的实例默认不写 BOM，也不解析 BOM：
- 如果输入字节以
0xEF 0xBB 0xBF开头，decode() 会把它当作普通 UTF-8 序列解成'\uFEFF'（零宽无间断空格） - 如需识别或写入 BOM，得手动判断/插入，或借助第三方库（如 Apache Commons Codec）
- 多数现代协议（HTTP、JSON）明确禁止 UTF-8 BOM，所以默认行为反而是合理的
