Spring Boot 默认仅从 @SpringBootApplication 类所在包及其子包中扫描组件，不会自动扫描同级或上级包；若启动类位置不当，即使代码存在语法错误也不会报错，导致实体、服务等 Bean 无法注册。
spring boot 默认仅从 `@springbootapplication` 类所在包及其子包中扫描组件，不会自动扫描同级或上级包；若启动类位置不当，即使代码存在语法错误也不会报错，导致实体、服务等 bean 无法注册。
在 Spring Boot 项目中，“组件未被扫描”是最常见却最易被忽视的启动问题之一。其根本原因并非配置缺失或依赖错误，而是 Spring Boot 的自动扫描机制有严格的包路径约束：@SpringBootApplication 注解本质是 @Configuration + @EnableAutoConfiguration + @ComponentScan 的组合，而默认的 @ComponentScan 仅启用基于启动类所在包的递归向下扫描（即“包树向下遍历”），绝不会跨级扫描兄弟包或向上扫描父包。
例如，若你的项目结构如下：
src/main/java/ ├── com/badas/todo/models/Tasks.java ← 实体类 ├── com/badas/todo/repositories/TaskRepository.java └── com/example/demo/ToDoApp4TryApplication.java ← 启动类（位于完全无关的包下）
此时 Spring Boot 仅扫描 com.example.demo 及其子包（如 com.example.demo.config），而 com.badas.todo.* 与其为兄弟包关系，因此 Tasks 实体、@Repository、@Service 等均不会被识别——JPA 无法发现实体，也就不会建表；甚至故意写错构造函数（如 public Tasks(InvalidType x) {}）也不会触发编译/启动异常，因为该类根本未被加载。
✅ 正确做法一（推荐）：统一包结构，将启动类置于顶层公共包下
将 ToDoApp4TryApplication 移至 com.badas.todo 包中（即与 models 平级），结构变为：
src/main/java/com/badas/todo/ ├── ToDoApp4TryApplication.java ← 启动类（包路径：com.badas.todo） ├── models/Tasks.java ├── repositories/TaskRepository.java └── TodoApplication.java (可选主类)
此时 @SpringBootApplication 默认扫描 com.badas.todo 下所有子包，Tasks 自然被识别为 JPA 实体，spring.jpa.hibernate.ddl-auto=update 即可生效。
✅ 正确做法二：显式声明扫描范围（适用于多模块或遗留结构调整困难场景）
在启动类上添加 @ComponentScan，明确指定需扫描的包：
@SpringBootApplication
@ComponentScan(basePackages = {
"com.badas.todo.models",
"com.badas.todo.repositories",
"com.badas.todo.services"
})
public class ToDoApp4TryApplication {
public static void main(String[] args) {
SpringApplication.run(ToDoApp4TryApplication.class, args);
}
}⚠️ 注意事项：
- basePackages 中的路径必须是实际存在的 Java 包名（对应目录结构），不可拼错或遗漏；
- 若使用 Lombok，确保 @Entity 类上有 @Data 或显式 getter/setter，否则 JPA 可能因无访问器而忽略字段；
- @Id 字段类型应与数据库主键类型匹配：示例中 private String task; 声明为 String，但 @GeneratedValue(strategy = GenerationType.IDENTITY) 要求数据库主键为自增整数（如 BIGINT），此处存在逻辑冲突，应改为：
@Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id; // 推荐作为主键
? 总结：Spring Boot 的“约定优于配置”不等于“无视结构”。启动类的位置即扫描根路径，这是理解自动装配的前提。调试时可添加日志确认扫描效果：
# application.properties logging.level.org.springframework.boot.autoconfigure=DEBUG logging.level.org.springframework.context.annotation=TRACE
启动后观察日志中是否出现 Scanning for beans... 及具体包路径，即可快速验证扫描范围是否符合预期。
