【Java】已解决：java.nio.charset.CharacterCodingException

屿小夏

已于 2024-09-21 12:09:21 修改

阅读量928

点赞数 13

文章标签： java nio python

于 2024-08-29 09:44:36 首次发布

本文链接：https://blog.csdn.net/a1657054242/article/details/141130039

版权

个人简介：某不知名博主，致力于全栈领域的优质博客分享 | 用最优质的内容带来最舒适的阅读体验！文末获取免费IT学习资料！

🍅 文末获取更多信息 🍅 👇🏻 精彩专栏推荐订阅收藏 👇🏻

专栏系列	直达链接	相关介绍
书籍分享	点我跳转	书籍作为获取知识的重要途径，对于IT从业者来说更是不可或缺的资源。不定期更新IT图书，并在评论区抽取随机粉丝，书籍免费包邮到家
AI前沿	点我跳转	探讨人工智能技术领域的最新发展和创新，涵盖机器学习、深度学习、自然语言处理、计算机视觉等领域的研究进展和趋势分析。通过深入解读前沿技术、案例研究和行业动向，为读者带来关于人工智能未来发展方向和应用前景的洞察和启发。
Elasticsearch	点我跳转	详解 Elasticsearch 搜索和数据分析引擎
科技前沿	点我跳转	本档是关于科技和互联网的专栏，旨在为读者提供有趣、有用、有深度的科技资讯和思考。从多个角度探讨科技与人类生活的关系，包括但不限于科技趋势、产品评测、技术解读、行业观察、创业故事等内容。希望通过本栏，与读者分享科技的魅力和思考，让科技成为我们生活的一部分，而不仅仅是一个陌生的词汇。
Java之光	点我跳转	本栏将带领读者深入探索Java编程世界的种种奥秘。无论你是初学者还是资深开发者，这里都将为你提供丰富的Java知识和实用的编程技巧。
Linux学习日志	点我跳转	本专栏致力于探索Linux操作系统的各个方面，包括基础知识、系统管理、网络配置、安全性等。通过深入浅出的文章和实践指南，帮助读者更好地理解和应用Linux，提高系统管理和开发技能。无论你是初学者还是有经验的Linux用户，都能在本专栏中找到有用的信息和解决方案。
MySQL之旅	点我跳转	专栏将带领读者进入MySQL数据库的世界，探索其强大的功能和应用。我们将深入探讨MySQL的基本概念、SQL语言的应用、数据库设计与优化、数据备份与恢复等方面的知识，并结合实际案例进行讲解和实践操作。
精通Python百日计划	点我跳转	我们将引领你踏上一段为期100天的编程之旅，逐步深入了解和掌握Python编程语言。无论你是编程新手还是有一定基础的开发者，这个专栏都会为你提供系统而全面的学习路径，帮助你在短短100天内成为Python高手。

文章目录

在Java开发中，字符编码问题往往是导致异常的一个主要来源。java.nio.charset.CharacterCodingException是一种常见的异常，通常出现在字符编码或解码操作过程中。本文将深入探讨该异常的背景、可能的原因、错误与正确的代码示例，并提供相关注意事项，帮助读者轻松解决这一问题。

一、分析问题背景

java.nio.charset.CharacterCodingException通常出现在处理字符流的编码或解码操作时。这一异常提示开发者，在将字节数据转换为字符数据（或反之）时，发生了编码或解码失败的情况。

常见的场景包括：

读取或写入文件时，指定的字符集编码与实际文件编码不匹配。
在网络通信中，传输的字节数据未能按照预期的字符集解码。
将字节数组转换为字符串或将字符串转换为字节数组时，使用了错误的字符集。

场景示例：

byte[] bytes = "hello".getBytes("UTF-8");
// 试图用不同的字符集解码
String str = new String(bytes, "ISO-8859-1"); // 这里可能引发CharacterCodingException

二、可能出错的原因

java.nio.charset.CharacterCodingException的产生原因主要包括以下几种：

字符集不匹配：编码时使用的字符集与解码时使用的字符集不一致，导致解码失败。
不支持的字符集：试图使用不被支持或存在问题的字符集进行编码或解码操作。
数据损坏：传输或存储过程中数据损坏，导致无法正常解码。
缓冲区问题：在使用CharsetDecoder或CharsetEncoder时，缓冲区未正确处理，导致部分字符无法正确编码或解码。

三、错误代码示例

下面是一个容易导致CharacterCodingException的错误代码示例：

import java.nio.charset.Charset;
import java.nio.charset.CharsetDecoder;
import java.nio.ByteBuffer;
import java.nio.CharBuffer;

public class CharacterCodingErrorExample {
    public static void main(String[] args) {
        byte[] bytes = { (byte)0xC3, (byte)0x28 }; // 非法的UTF-8字节序列
        Charset charset = Charset.forName("UTF-8");
        CharsetDecoder decoder = charset.newDecoder();
        
        try {
            ByteBuffer byteBuffer = ByteBuffer.wrap(bytes);
            CharBuffer charBuffer = decoder.decode(byteBuffer); // 这里将抛出CharacterCodingException
        } catch (CharacterCodingException e) {
            e.printStackTrace();
        }
    }
}

错误分析：

在这个例子中，字节数组包含了非法的UTF-8字节序列，导致CharsetDecoder在解码时抛出了CharacterCodingException。
此外，未正确处理可能的异常情况，未考虑字节数组的来源和完整性。

四、正确代码示例

为了正确处理字符编码问题，应该仔细处理字符集的选择，并正确管理异常。下面是一个修正后的代码示例：

import java.nio.charset.Charset;
import java.nio.charset.CharsetDecoder;
import java.nio.charset.CodingErrorAction;
import java.nio.ByteBuffer;
import java.nio.CharBuffer;

public class CharacterCodingCorrectExample {
    public static void main(String[] args) {
        byte[] bytes = { (byte)0xC3, (byte)0x28 }; // 非法的UTF-8字节序列
        Charset charset = Charset.forName("UTF-8");
        CharsetDecoder decoder = charset.newDecoder();
        
        // 设置解码时的错误处理动作
        decoder.onMalformedInput(CodingErrorAction.REPORT);
        decoder.onUnmappableCharacter(CodingErrorAction.REPORT);
        
        try {
            ByteBuffer byteBuffer = ByteBuffer.wrap(bytes);
            CharBuffer charBuffer = decoder.decode(byteBuffer); // 仍可能抛出CharacterCodingException
        } catch (CharacterCodingException e) {
            System.out.println("解码失败，字节序列不合法。");
            // 处理异常或使用备用方案
        }
    }
}