MySQL连接异常：配置文件参数失败，硬编码相同参数成功

核心问题定位 #

虽然配置文件里的参数看起来和硬编码一致，但实际读取到的参数存在隐形差异，导致MySQL认证失败。以下是针对性排查步骤：

• 检查配置文件的隐形字符与编码
  用纯文本编辑器（VS Code/Notepad++）打开db.properties，开启显示所有字符（VS Code可通过View > Render Whitespace开启），确认：

  • 键值对没有多余空格、制表符或换行符（比如jdbc.password= 123456789末尾的空格会被当成密码的一部分）
  • 配置文件编码为UTF-8无BOM格式，BOM头会被读取为参数前缀，导致账号密码不符

• 验证读取逻辑与参数输出
  在读取配置后立即打印参数值：

  String url = props.getProperty("jdbc.url");
  String user = props.getProperty("jdbc.user");
  String password = props.getProperty("jdbc.password");
  System.out.println("读取到的URL: [" + url + "]");
  System.out.println("读取到的用户: [" + user + "]");
  System.out.println("读取到的密码: [" + password + "]");
  

  对比硬编码的字符串，确认括号内的内容完全一致（包括大小写、特殊字符），同时检查是否存在配置项拼写错误（比如把jdbc.password写成db.pass）

• 确认配置文件格式规范
  确保db.properties的键值对格式符合标准，避免等号两侧加空格：

  # 正确格式
  jdbc.url=jdbc:mysql://localhost:3306/teste
  jdbc.user=root
  jdbc.password=123456789
  
  # 错误格式（等号两侧的空格会被读取到参数中）
  jdbc.url = jdbc:mysql://localhost:3306/teste
  

• 排查类加载路径问题
  确认配置文件在正确的类加载路径下（比如Maven项目的src/main/resources），编译后会被打包到classpath中。可通过以下代码打印配置文件实际路径，确认读取的是目标文件：

  URL configPath = Thread.currentThread().getContextClassLoader().getResource("db.properties");
  System.out.println("配置文件实际路径: " + configPath);
  

• 字节级对比参数
  在IDE调试模式下，查看读取到的参数变量的char数组，和硬编码字符串做字节级对比，排查肉眼不可见的编码差异（比如全角/半角字符、控制字符）

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