Java字符编码转换需显式指定StandardCharsets常量，禁用平台默认编码，提供toEncoding和convert两个核心方法，并做好空值与异常防护。
Java 中处理字符编码转换，核心在于正确使用 String 的构造方法和 getBytes() 方法，并规避平台默认编码带来的不确定性。一个通用、安全的编码转换工具类，关键不是“支持所有编码”，而是明确输入输出编码、避免依赖系统默认编码、处理异常并提供合理回退机制。
明确指定编码，禁用平台默认编码
Java 的 new String(byte[]) 和 String.getBytes() 若不传编码名，会使用 Charset.defaultCharset()，而该值在不同环境（Windows/Linux/macOS、IDE/终端/容器）下可能不同，极易导致乱码。必须显式传入标准编码名（如 "UTF-8"、"GBK"、"ISO-8859-1"）。
建议统一使用 StandardCharsets 中的常量（JDK 7+），类型安全且无需捕获 UnsupportedEncodingException：
StandardCharsets.UTF_8-
StandardCharsets.GBK（注意：GBK 不是标准常量，需手动写字符串或封装） StandardCharsets.ISO_8859_1
基础转换方法：字节数组 ↔ 字符串
这是最常用、最可控的转换方式。工具类应提供两个核心方法：
立即学习“Java免费学习笔记（深入）”；
-
toEncoding(byte[] bytes, Charset srcCharset, Charset targetCharset)：将字节数组按源编码解码为字符串，再按目标编码编码为新字节数组 -
convert(String str, Charset fromCharset, Charset toCharset)：将字符串从一种编码“重解释”为另一种（适用于 ISO-8859-1 ↔ UTF-8 等常见误读场景）
示例实现（含空值与异常防护）：
public static byte[] toEncoding(byte[] bytes, Charset srcCharset, Charset targetCharset) {
if (bytes == null || srcCharset == null || targetCharset == null) {
return new byte[0];
}
try {
String decoded = new String(bytes, srcCharset);
return decoded.getBytes(targetCharset);
} catch (Exception e) {
throw new IllegalArgumentException("Encoding conversion failed", e);
}
}
public static String convert(String str, Charset fromCharset, Charset toCharset) {
if (str == null || fromCharset == null || toCharset == null) return str;
try {
return new String(str.getBytes(fromCharset), toCharset);
} catch (Exception e) {
throw new IllegalArgumentException("String encoding conversion failed", e);
}
}
</font>
<H3>支持常见中文编码自动识别（可选增强）</H3>
<p>纯通用工具类不强制包含自动识别，但实际业务中常需判断字节数组是 GBK 还是 UTF-8。可封装轻量级检测逻辑（非 100% 准确，但覆盖主流情况）：</p>
<ul>
<li>先尝试用 UTF-8 解码，若抛 <code>MalformedInputException</code>，再试 GBK</li>
<li>检查 BOM（\uFEFF）判断 UTF-8/UTF-16</li>
<li>对无 BOM 的字节数组，用简单启发式规则（如 UTF-8 多字节序列合法性）</li>
</ul>
<p>注意：不要依赖第三方库（如 juniversalchardet）做通用工具类，会增加依赖；如需高精度识别，应单独封装为可选模块。</p>
<H3>使用示例与避坑提醒</H3>
<p>✅ 正确用法：</p>
<font color="#888">
<pre class="brush:php;toolbar:false;">
// 将 GBK 编码的请求参数转为 UTF-8 字符串
byte[] gbkBytes = request.getParameter("name").getBytes(StandardCharsets.ISO_8859_1); // 常见 Servlet 误传
String name = EncodingUtils.convert(new String(gbkBytes, Charset.forName("GBK")),
Charset.forName("GBK"), StandardCharsets.UTF_8);
// 安全写文件（明确指定编码）
Files.write(path, content.getBytes(StandardCharsets.UTF_8), StandardOpenOption.CREATE);
❌ 常见错误：
-
new String(bytes)—— 隐式用系统默认编码，不可控 -
str.getBytes()—— 同上，写日志或网络传输时极易乱码 - 混淆“解码”和“重编码”：把 UTF-8 字节流当 GBK 解，再用 UTF-8 编，结果仍是乱码（应先用 GBK 解，再用 UTF-8 编）
不复杂但容易忽略。只要坚持显式指定编码、用 StandardCharsets、封装好异常，就能覆盖 95% 的编码转换需求。
