Spring Boot令牌认证应用启动失败：JwtConfig Bean找不到问题求助

这个错误其实很常见，核心原因就是Spring容器找不到你定义的JwtConfig这个Bean，导致没法注入到JwtTokenService的构造函数里。咱们来一步步分析原因和解决办法：

错误原因拆解 #

你已经给JwtConfig加了@Component注解，理论上Spring应该把它注册成Bean，但实际没找到，大概率是包扫描范围的问题。Spring Boot默认只会扫描主启动类（带@SpringBootApplication的类）所在的包及其所有子包里的@Component、@Service等注解类。如果你的JwtConfig所在的config包不在这个扫描范围内，Spring就看不到它。

举个例子：如果你的主启动类在com.myproject.app包下，而JwtConfig在com.myproject.config包下（和app同级），那默认扫描不到config包；但如果JwtConfig在com.myproject.app.config（app的子包），就会被自动扫描到。

具体解决方案 #

方案1：调整包结构（最推荐） #

把你的JwtConfig类移到主启动类所在包的子包下。比如主启动类在com.myproject，那就把JwtConfig放到com.myproject.config里。这样不用改任何代码，Spring会自动扫描到这个类并注册成Bean。

方案2：手动指定扫描范围 #

如果不想调整包结构，就在主启动类上添加@ComponentScan注解，明确指定要扫描的包。比如：

@SpringBootApplication
@ComponentScan(basePackages = {"com.myproject.app", "com.myproject.config"})
// 把JwtConfig所在的config包添加到扫描列表里
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

额外检查点 #

顺便确认一下Lombok的依赖是否正确引入了——你的JwtConfig用了@Data和@NoArgsConstructor，如果Lombok没生效，虽然不会直接导致Bean找不到，但可能后续出现其他问题。确保你的pom.xml（或build.gradle）里有Lombok依赖，并且IDE开启了Lombok支持。

验证方法 #

修改后重新启动应用，如果错误消失，说明问题解决了。这时候Spring会成功注册JwtConfig Bean，并注入到JwtTokenService中。

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