SpringBoot3中application.properties无法正确注入User类name属性问题

可能的原因及解决方案 #

1. 系统属性/环境变量覆盖了配置值

SpringBoot的属性加载优先级中，系统属性（JVM参数）> 环境变量 > application.properties。user.name是Java内置的系统属性，默认会读取操作系统的用户名，如果启动时JVM参数设置了-Duser.name=inf，或者系统环境变量中存在USER_NAME=inf（Spring会自动将下划线转为点），就会直接覆盖配置文件中的值。

排查方法：
在代码中添加调试代码，打印系统属性值：

System.out.println("系统user.name值：" + System.getProperty("user.name"));

如果输出是inf，说明确实被系统属性覆盖。

解决方法：

• 移除启动时的-Duser.name参数；
• 或者修改配置文件的前缀，避免和系统属性冲突，比如将前缀改为my.user：

  # application.properties
  my.user.name=bob
  my.user.age=17
  

  然后修改User类的注解：

  @Component
  @ConfigurationProperties(prefix = "my.user")
  public class User {
      private String name;
      private Integer age;
      // 正确的setter/getter
      public void setName(String name) {
          this.name = name;
      }
      public void setAge(Integer age) {
          this.age = age;
      }
      // getter方法
  }
  

2. User类的属性绑定不符合规范

@ConfigurationProperties默认通过setter方法注入属性，需要确保：

• name字段是非static的私有字段；
• 存在对应的public void setName(String name)方法，方法名严格遵循驼峰命名（字段name对应setName，不是setUserName）；
• 没有手动给name字段赋值为inf（比如初始化时private String name = "inf"）。

排查方法：
检查User类的代码，确认字段初始化和setter方法是否正确，比如避免以下错误：

// 错误示例：初始化了默认值
private String name = "inf";

// 错误示例：setter方法名错误
public void setUserName(String name) {
    this.name = name;
}

3. 验证属性绑定是否生效

可以通过@Value注解快速验证配置值是否能被读取：

@Component
public class TestComponent {
    @Value("${user.name}")
    private String userName;

    @PostConstruct
    public void init() {
        System.out.println("@Value读取的user.name：" + userName);
    }
}

如果@Value读取到的也是inf，说明问题出在属性来源（系统属性/环境变量）；如果@Value能读取到bob，说明@ConfigurationProperties的绑定存在问题，需要检查User类是否被Spring正确扫描（SpringBoot3中加了@Component的类默认会被扫描）。

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