Spring MVC配置PostgreSQL数据源时读取username返回主机用户名的问题

这个问题的核心是Spring Environment的属性源优先级导致的命名冲突：

当你调用environment.getProperty("username")时，Spring会按照预设的优先级顺序查找属性值，而系统环境变量的优先级远高于你自定义的database.properties配置文件。几乎所有操作系统（不管是Docker容器所在的Linux主机，还是容器内部的系统）都存在名为username（Windows）或USER（类Unix系统，包括Docker容器内的系统）的环境变量，所以你拿到的其实是主机/容器系统的用户名，而非配置文件里的postgres。

解决方案（推荐第一种） #

1. 给配置文件属性添加前缀（最优雅的解决方式） #

修改你的database.properties，给所有数据库相关属性加上统一前缀，避免和系统环境变量重名：

db.driver=org.postgresql.Driver 
db.url=jdbc:postgresql://172.17.0.2:5432/first_db
db.username=postgres
db.password=mypassword

然后修改dataSource()方法，使用带前缀的属性名读取：

@Bean
public DataSource dataSource() {
    DriverManagerDataSource dataSource = new DriverManagerDataSource();

    dataSource.setDriverClassName(Objects.requireNonNull(environment.getProperty("db.driver")));
    dataSource.setUrl(environment.getProperty("db.url"));
    dataSource.setUsername(environment.getProperty("db.username")); // 现在会读取配置文件里的postgres
    dataSource.setPassword(environment.getProperty("db.password"));

    return dataSource;
}

这种方式从根源上避免了命名冲突，也是Spring配置的最佳实践之一。

2. 直接从Properties对象读取配置文件（绕过Environment优先级） #

如果不想修改配置文件的键名，可以直接加载配置文件到Properties对象，跳过Spring Environment的优先级检索：

@Bean
public DataSource dataSource() throws IOException {
    DriverManagerDataSource dataSource = new DriverManagerDataSource();
    Properties dbProps = new Properties();
    // 加载resources下的database.properties文件
    dbProps.load(getClass().getResourceAsStream("/database.properties"));
    
    dataSource.setDriverClassName(dbProps.getProperty("driver"));
    dataSource.setUrl(dbProps.getProperty("url"));
    dataSource.setUsername(dbProps.getProperty("username"));
    dataSource.setPassword(dbProps.getProperty("password"));

    return dataSource;
}

注意：这种方式会失去Spring Environment提供的自动配置、属性占位符等能力，仅适合简单场景。

验证方法 #

你可以在代码里临时添加打印语句，确认问题所在：

System.out.println("系统环境变量username: " + environment.getProperty("username"));
System.out.println("配置文件username: " + environment.getProperty("db.username")); // 如果你用了前缀

运行后就能看到两者的区别，进一步验证优先级问题。

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