Android使用Commons IO写入文件遇UnsupportedEncodingException问题求助

问题分析 #

你碰到的这个异常，核心原因是错误地使用了StandardCharsets.UTF_8.toString()作为编码参数。StandardCharsets.UTF_8是一个Charset实例，它的toString()方法返回的不是我们需要的纯编码名称（比如"UTF-8"），而是包含类名的描述字符串java.nio.charset.CharsetICU[UTF-8]——这个字符串根本不是有效的字符集名称，所以底层的Charset.forNameUEE方法直接抛出了非法字符集名称的异常，最终导致了UnsupportedEncodingException。

另外补充一点：你当前使用的commons-io:1.3.2是比较老旧的版本，这个版本的FileUtils.writeStringToFile方法只支持传入字符串类型的编码名称，没有提供直接接收Charset对象的重载方法，这也是问题出现的一个背景因素。

两种可行的解决方案 #

方案1：直接传入编码名称字符串（快速修复）

不需要修改依赖，只需要把代码里的StandardCharsets.UTF_8.toString()替换成纯字符串"UTF-8"即可：

val file = File(folderPath + File.separator + resultFileName)
FileUtils.writeStringToFile(file, fileContents, "UTF-8")

这样传入标准的编码名称，就能被底层正确识别，不会再抛出编码异常。

方案2：升级Commons IO版本（推荐长期方案）

建议把commons-io的版本升级到2.11.0及以上，新版本的FileUtils提供了直接接收Charset对象的重载方法，这样你可以直接使用StandardCharsets.UTF_8，完全避免字符串转换的错误：

首先修改build.gradle中的依赖：

api 'org.apache.commons:commons-io:2.11.0'

然后修改代码：

val file = File(folderPath + File.separator + resultFileName)
FileUtils.writeStringToFile(file, fileContents, StandardCharsets.UTF_8)

升级版本不仅能解决这个问题，还能获得库的新特性和bug修复，对项目长期维护更有利。

总结 #

如果只是临时快速解决问题，方案1足够；如果希望代码更健壮、避免类似问题，方案2是更优的选择。两种方案都能有效解决你遇到的UnsupportedEncodingException异常。

内容的提问来源于stack exchange，提问作者Alexei