在Java项目里读取MySQL数据库配置文件，最稳妥的方式是通过Spring Boot的@ConfigurationProperties注解绑定配置属性，同时保留传统Properties类加载作为备选方案，具体选哪种取决于项目架构。
Java读取MySQL数据库配置文件的三种主流方式
从早期JDBC到如今Spring Boot微服务，读取配置文件的模式一直在演进，下面梳理三种最常见的方式，你可以根据项目阶段和技术栈选择。
使用Properties类手动加载
这是最基础的方式,适合纯JDBC项目或非Spring环境，通常在代码中通过Properties.load(InputStream)读取classpath下的jdbc.properties文件。
Properties props = new Properties();
InputStream input = getClass().getClassLoader().getResourceAsStream("jdbc.properties");
props.load(input);
String url = props.getProperty("jdbc.url");
String username = props.getProperty("jdbc.username");
String password = props.getProperty("jdbc.password");
优点：零依赖，在任何Java环境中都能跑。缺点：需要手动管理文件路径，且无法直接与连接池集成，多数情况下，这种方式只适合快速验证或遗留系统，如果配置项较多，建议改用后者。
基于Spring框架的@Value和@ConfigurationProperties
Spring框架提供了更优雅的解决方案,将数据库配置写在application.yml或application.properties中，通过@Value注解注入单个属性，或通过@ConfigurationProperties绑定为Java对象。
使用@Value示例：
@Value("${spring.datasource.url}")
private String dbUrl;
使用@ConfigurationProperties示例：
@ConfigurationProperties(prefix = "spring.datasource")
public class DataSourceProperties {
private String url;
private String username;
private String password;
// getters/setters
}
推荐原因：Spring Boot会自动读取application.properties
或application.yml，无需手动写加载代码，同时支持类型安全校验、多环境配置（application-dev.yml等），是当前行业共识的主流做法。
通过连接池直接读取配置文件
在性能敏感场景下,通常会使用HikariCP、Druid等连接池，连接池本身会读取配置文件中的spring.datasource相关属性并自动初始化，以Druid为例，只需在配置文件中声明：
spring.datasource.type=com.alibaba.druid.pool.DruidDataSource spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver spring.datasource.url=jdbc:mysql://localhost:3306/test?useSSL=false spring.datasource.username=root spring.datasource.password=123456
Spring Boot会自动装配Druid数据源，开发者不需要手写任何读取代码，这种方式下，Java读取MySQL数据库配置文件的职责被转移到了框架内部，开发者只需关注配置内容本身。
Java读取MySQL配置文件如何实现多环境切换
开发、测试、生产环境通常使用不同的数据库，如果不做环境隔离，每次部署都要手动改配置，容易出错，业内专家指出，多环境配置管理的核心是“配置外部化”。
通过Spring Profile实现环境隔离
在resources目录下创建多个配置文件：
application-dev.yml：开发环境application-test.yml：测试环境application-prod.yml：生产环境
主配置文件application.yml中指定激活哪个环境：
spring:
profiles:
active: dev
运行Jar时通过参数覆盖：java -jar app.jar --spring.profiles.active=prod，这样java读取mysql配置文件时会根据环境加载对应的文件，无需修改代码。
配置文件放在classpath还是外部目录
classpath下的配置文件会随Jar包一起打包,方便但不灵活，生产环境推荐将配置文件放在Jar包外的指定目录，如/etc/config/，通过spring.config.additional-location
或spring.config.location指定外部路径：
java -jar app.jar --spring.config.location=file:/etc/config/
这样数据库配置可以在不重新打包的情况下修改,尤其适合运维团队，据统计，近几年采用外部化配置的企业比例已相当大，这是高可用部署的常见要求。
Java读取MySQL配置文件报错怎么办常见问题排查
“java读取mysql配置文件报错” 是开发者经常搜索的关键词，问题通常集中在路径、编码和格式上。
文件路径找不到
- 确认配置文件是否在
resources目录下（Maven项目），使用getResourceAsStream时，路径不需要带开头，但文件必须位于classpath中。 - 如果使用
FileInputStream，需要提供绝对路径或相对路径，这在生产环境容易出错，建议优先使用classpath加载。 - 检查是否拼写错误：
jdbc.propertiesvsjdbc.propertie。
配置文件编码导致乱码
中文备注或特殊字符可能导致乱码,确保文件保存为UTF-8编码，并在读取时指定编码：
props.load(new InputStreamReader(input, "UTF-8"));
Spring Boot默认使用UTF-8读取，但如果你手动加载Properties，则需要显式编码。
配置项名称与绑定不匹配
使用@ConfigurationProperties时，如果前缀的字段名写错，或属性名大小写不一致，会导致绑定失败，例如spring.datasource.url写成了spring.datasource.Url，建议开启Spring Boot的宽松绑定（Relaxed Binding），它支持url、URL、Url等多种写法，但最好还是统一使用小写。
Java读取MySQL数据库配置文件实战：从配置到连接池集成
理解完理论,我们走一遍完整流程，假设你正在搭建一个Spring Boot项目，需要java读取mysql数据库配置文件步骤如下：
- 创建配置文件：在
src/main/resources/application.yml中写入：
spring: datasource: url: jdbc:mysql://localhost:3306/mydb username: root password: mypass driver-class-name: com.mysql.cj.jdbc.Driver
- 添加依赖：
pom.xml中加入spring-boot-starter-data-jpa或spring-boot-starter-jdbc，以及MySQL驱动。 - 自动配置：Spring Boot会自动读取配置，创建
DataSource，你可以在代码中通过@Autowired DataSource直接使用。 - 验证连接：启动项目，观察控制台日志，确认连接池初始化成功。
如果使用非Spring项目,比如传统Servlet，手动Properties加载后，可以用DriverManager.getConnection(url, props)获取连接，但这种方式不推荐用于生产。
Java读取MySQL数据库配置文件常见问题（Q&A）
Q1：java读取配置文件读取不到，提示文件找不到怎么办？
A：检查文件是否在classpath下，Maven项目默认将src/main/resources下的文件放入classpath，如果文件放在其他目录，需要手动指定路径，使用Thread.currentThread().getContextClassLoader().getResourceAsStream("config.properties")能解决大部分路径问题，如果还不行，确认文件是否被正确编译到了target/classes目录。
Q2：java读取mysql配置文件用properties还是yml？
A：两者没有本质区别，Spring Boot同时支持，properties文件结构扁平，适合简单配置；yml文件支持层级结构和数组，更清晰，行业共识是：新项目优先使用yml，遗留项目保持properties，如果团队已经习惯properties，继续使用也不影响功能。
Q3：java读取远程mysql配置文件是否安全？
A：将配置文件放在远程（如Git仓库、配置中心）可以有效避免敏感信息泄露，但需要做好传输加密和访问控制，Spring Cloud Config或Nacos可以做到动态刷新配置，但普通项目直接将配置文件放在服务器外部目录并设置文件权限，已经能满足大部分安全需求，密码本身不建议明文存储，可结合Jasypt等工具加密。
首发原创文章，作者：王坚，如若转载，请注明出处：https://test.idctop.com/article/549281.html
