@Value无法读取application.properties，JWT签名密钥始终为null

常见原因及修复步骤 #

1. 确保类被Spring容器管理 #

• 检查JWTTokenService和JWTTokenProperties是否添加Spring组件注解：JWTTokenService加@Service，JWTTokenProperties加@Component或@ConfigurationProperties（配置绑定更规范）。未添加注解的类不会被Spring扫描，@Value自然无法生效。
  • JWTTokenProperties示例：

    @Component
    @ConfigurationProperties(prefix = "jwt")
    public class JWTTokenProperties {
        private String signingKey;
        
        // 生成getter/setter方法
    }
    

  • JWTTokenService示例：

    @Service
    public class JWTTokenService implements TokenService {
        // 注入逻辑写在这里
    }
    

2. 禁止手动创建实例 #

• 绝对不能用new JWTTokenService()或new JWTTokenProperties()创建对象，必须通过Spring容器获取（比如构造器注入、@Autowired）。手动创建的对象不在Spring管理范围内，@Value注入逻辑不会触发。
  • 错误示例：

    // 这种方式创建的实例，Spring不会注入任何属性
    TokenService tokenService = new JWTTokenService();
    

  • 正确示例：

    @Service
    public class BusinessService {
        private final TokenService tokenService;
        
        // 推荐构造器注入
        public BusinessService(TokenService tokenService) {
            this.tokenService = tokenService;
        }
    }
    

3. 核对配置项名称 #

• 确保application.properties中的配置key和@Value表达式完全匹配，注意短横线和驼峰的对应（用@ConfigurationProperties时Spring会自动转换）。
  • 配置文件示例：

    jwt.signing-key=your-actual-secret-key
    

  • 对应@Value注入：

    @Value("${jwt.signing-key}")
    private String signingKey;
    

4. 确认配置文件位置与环境 #

• 保证application.properties放在src/main/resources下；如果是多环境配置，检查当前激活环境的配置文件（比如application-dev.properties）中是否包含签名密钥配置。

5. 优先用构造器注入替代@Value #

• 对于JWTTokenService，建议通过构造器注入JWTTokenProperties，既避免注入时机问题，也更利于单元测试和依赖管理。

  @Service
  public class JWTTokenService implements TokenService {
      private final String signingKey;
      
      public JWTTokenService(JWTTokenProperties properties) {
          this.signingKey = properties.getSigningKey();
      }
  }
  

6. 检查启动类扫描范围 #

• 确认启动类的@SpringBootApplication注解所在包是所有组件的父包，或通过scanBasePackages指定扫描范围，否则Spring无法发现你的JWTTokenService和JWTTokenProperties。

  @SpringBootApplication(scanBasePackages = "com.your.project.package")
  public class Application {
      public static void main(String[] args) {
          SpringApplication.run(Application.class, args);
      }
  }
  

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