Java 读取配置文件路径与中文乱码问题全解析-拓冰建站

1. 引言

在 Java 开发中，读取配置文件（如.properties、.yml、.xml）是家常便饭。然而，两个经典问题常常困扰着开发者：

配置文件路径问题：明明文件就在项目里，程序却报FileNotFoundException。
中文乱码问题：配置文件里写了中文注释或值，读取出来却是一堆???或乱码。

本文将深入剖析这两个问题的根源，并提供一套标准、可靠的解决方案。

2. 配置文件路径问题

2.1 路径分类

Java 读取文件时，路径主要分为两类：

绝对路径：从盘符或根目录开始的完整路径，如D:/config/app.properties。可移植性差，不推荐在项目中使用。
相对路径：相对于程序当前工作目录（user.dir）的路径。在 IDE 中运行和命令行打包运行时，工作目录可能不同，容易出错。

2.2 推荐方案：从 classpath 读取

最稳妥的方式是将配置文件放在resources目录下（即 classpath 的根路径），然后通过类加载器读取。

项目结构示例：

src/ └── main/ ├── java/ │ └── com/example/Demo.java └── resources/ └── config.properties

核心代码：

importjava.io.InputStream;importjava.util.Properties;publicclassConfigReader{publicstaticPropertiesloadProperties(StringfileName){Propertiesprops=newProperties();// 使用当前线程的类加载器获取资源流try(InputStreaminput=Thread.currentThread().getContextClassLoader().getResourceAsStream(fileName)){if(input==null){System.out.println("抱歉，未在 classpath 中找到文件: "+fileName);returnprops;}props.load(input);}catch(Exceptione){e.printStackTrace();}returnprops;}publicstaticvoidmain(String[]args){Propertiesprops=loadProperties("config.properties");System.out.println(props.getProperty("app.name"));}}

关键点：

getResourceAsStream()方法会自动从 classpath 的根路径开始查找文件。
打包成 JAR 后，resources目录下的文件会被打包进 JAR 内部，上述代码依然有效。

2.3 获取文件的其他方式

Class.getResourceAsStream()：路径以/开头表示从 classpath 根路径查找，否则相对于该类所在的包路径。
ClassLoader.getSystemResourceAsStream()：使用系统类加载器，在某些 Web 容器中可能失效，不推荐。

3. 中文乱码问题

3.1 乱码根源

Properties类的load()方法默认使用ISO-8859-1 (Latin-1)字符编码读取文件。ISO-8859-1 不支持中文字符，因此直接读取包含中文的.properties文件必然出现乱码。

3.2 解决方案

方案一：使用 UTF-8 编码读取（推荐）

从 Java 9 开始，Properties类提供了load(Reader reader)方法，允许我们指定字符编码。

importjava.io.InputStreamReader;importjava.nio.charset.StandardCharsets;publicstaticPropertiesloadPropertiesUtf8(StringfileName){Propertiesprops=newProperties();try(InputStreaminput=Thread.currentThread().getContextClassLoader().getResourceAsStream(fileName);InputStreamReaderreader=newInputStreamReader(input,StandardCharsets.UTF_8)){if(input==null){System.out.println("文件未找到: "+fileName);returnprops;}props.load(reader);}catch(Exceptione){e.printStackTrace();}returnprops;}

方案二：使用 native2ascii 转码（传统方案）

在 Java 8 及更早版本中，或需要兼容老旧系统时，可以使用 JDK 自带的native2ascii工具将中文转换为 Unicode 转义序列。

转换前（config.properties）：

app.name=应用名称

转换后（config.properties）：

app.name=\u5E94\u7528\u540D\u79F0

转换命令：

native2ascii-encodingUTF-8 src.properties dst.properties

方案三：使用 Yaml 或 JSON 配置文件

YAML 和 JSON 格式原生支持 UTF-8 编码，不存在Properties类的编码问题。配合 Spring Boot 等框架使用非常方便。

application.yml 示例：

app:name:应用名称version:1.0.0

4. 完整示例与最佳实践

4.1 工具类封装

将上述最佳实践封装成一个工具类，方便复用：

importjava.io.*;importjava.nio.charset.StandardCharsets;importjava.util.Properties;publicclassPropertiesUtil{/** * 从 classpath 加载 properties 文件（UTF-8 编码） * * @param fileName 文件名，如 "config.properties" * @return Properties 对象 */publicstaticPropertiesload(StringfileName){Propertiesprops=newProperties();try(InputStreaminput=PropertiesUtil.class.getClassLoader().getResourceAsStream(fileName)){if(input==null){thrownewFileNotFoundException("配置文件 '"+fileName+"' 未在 classpath 中找到。");}// 使用 InputStreamReader 指定 UTF-8 编码try(Readerreader=newInputStreamReader(input,StandardCharsets.UTF_8)){props.load(reader);}}catch(IOExceptione){System.err.println("加载配置文件失败: "+e.getMessage());}returnprops;}publicstaticvoidmain(String[]args){Propertiesprops=PropertiesUtil.load("config.properties");Stringname=props.getProperty("app.name","默认值");System.out.println("应用名称: "+name);}}

4.2 常见问题排查

文件未找到：确认文件确实在src/main/resources/目录下；检查文件名大小写（Linux 系统区分大小写）。
IDE 中正常，打包 JAR 后报错：确保构建工具（Maven/Gradle）已将resources目录下的文件包含在打包配置中。
读取到null：检查properties文件中的键名是否拼写正确，或使用getProperty(key, defaultValue)提供默认值。