Spring Boot中@Value无法读取application.properties的GraphQL地址问题

1. 确认FetchAPI类是否被Spring容器管理 #

• 必须给FetchAPI类加上@Component（或@Service/@Repository）注解，只有被Spring扫描并纳入容器的类，@Value才会生效。如果是手动new的实例，Spring不会帮你注入配置值。
• 检查@ComponentScan的扫描范围，要确保覆盖了FetchAPI所在的包。比如主启动类在com.example.demo，而FetchAPI在com.example.api，就得把@ComponentScan(basePackages = {"com.example.demo", "com.example.api"})里的包路径补全。

2. 核对配置键名与格式 #

• 确认application.properties里的配置键是graphql.endpoint，别写错大小写、漏了字符或者多打空格（Spring Boot配置键默认大小写不敏感，但尽量保持一致避免坑）。
• URL格式要正确，比如graphql.endpoint=http://localhost:8080/graphql，不能缺了http://或者https://协议头。

3. 检查@Value注解的写法 #

• 确保语法正确，比如：

  @Value("${graphql.endpoint}")
  private String graphqlEndpoint;
  

  注意美元符号和大括号的位置，别写错。
• 别在静态字段上直接用@Value，Spring没法直接注入静态属性。如果非要用静态字段，得通过setter方法注入：

  private static String graphqlEndpoint;
  
  @Value("${graphql.endpoint}")
  public void setGraphqlEndpoint(String endpoint) {
      graphqlEndpoint = endpoint;
  }
  

4. 排查配置文件加载优先级 #

• 确认修改的是src/main/resources/application.properties，不是其他环境的配置文件（比如application-dev.properties）。如果启动时指定了环境参数（比如--spring.profiles.active=dev），就得对应修改对应环境的配置文件。
• 启动jar包时加--debug参数，查看Spring Boot加载的配置详情，确认graphql.endpoint的最终取值，排查是否被环境变量、命令行参数等其他配置源覆盖。

5. 保证WebClient初始化时机正确 #

• 如果FetchAPI里是在构造方法中初始化WebClient，要确保@Value注入的字段已经赋值。推荐用构造方法注入替代字段注入，更稳妥：

  @Component
  public class FetchAPI {
      private final WebClient webClient;
      private final String graphqlEndpoint;
  
      public FetchAPI(@Value("${graphql.endpoint}") String graphqlEndpoint) {
          this.graphqlEndpoint = graphqlEndpoint;
          this.webClient = WebClient.builder().baseUrl(graphqlEndpoint).build();
      }
  }
  

  这种方式能避免构造方法执行时配置值还没注入的问题。

6. 清理缓存重新构建 #

• 执行mvn clean package（别用install，避免本地仓库缓存干扰），然后重新启动jar包。有时候旧的class文件缓存会导致配置注入不生效。
• 在VSCode里可以先删掉项目的target目录，再重新构建。

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