Spring项目包扫描异常：无法自动建表与注入MapStruct Bean

• Spring Boot练习项目主类TicketApplication位于根包it.prenota.ticket，可正常连接PostgreSQL数据库，但JPA无法自动生成表，需手动创建
• MapStruct实现的PazienteMapper无法通过@Autowired注入，提示找不到对应Bean
• Controller可通过Postman正常访问，但部分子包未被Spring自动扫描；临时添加@ComponentScan解决了Mapper注入问题，但JPA实体类扫描异常仍存在

1. 检查JPA实体类配置 #

• 确保所有需要自动建表的实体类添加了@Entity注解，且所在包为it.prenota.ticket的直接/间接子包（如it.prenota.ticket.entity）
• 若实体类在非默认扫描的子包，在主类添加@EntityScan指定实体类路径：

@SpringBootApplication
@EntityScan(basePackages = "it.prenota.ticket.entity") // 替换为你的实体类实际包路径
public class TicketApplication {
    public static void main(String[] args) {
        SpringApplication.run(TicketApplication.class, args);
    }
}

2. 验证JPA自动建表配置 #

检查application.yml中JPA配置是否开启自动建表：

spring:
  jpa:
    hibernate:
      ddl-auto: update # 可选create/create-drop，根据需求选择；设为none会关闭自动建表
    show-sql: true # 开启可查看建表SQL，排查执行问题
    properties:
      hibernate:
        dialect: org.hibernate.dialect.PostgreSQLDialect # 确保使用PostgreSQL适配方言

3. 修复MapStruct Mapper的Bean生成 #

• 确保PazienteMapper接口添加@Mapper(componentModel = "spring")，让MapStruct生成Spring管理的Bean：

@Mapper(componentModel = "spring")
public interface PazienteMapper {
    // 映射方法定义
}

• 检查pom.xml中MapStruct依赖与编译插件配置，确保编译时生成Mapper实现类：

<dependencies>
    <dependency>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct</artifactId>
        <version>1.5.5.Final</version> <!-- 使用最新稳定版 -->
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.11.0</version>
            <configuration>
                <source>17</source> <!-- 匹配项目使用的JDK版本 -->
                <target>17</target>
                <annotationProcessorPaths>
                    <path>
                        <groupId>org.mapstruct</groupId>
                        <artifactId>mapstruct-processor</artifactId>
                        <version>1.5.5.Final</version>
                    </path>
                </annotationProcessorPaths>
            </configuration>
        </plugin>
    </plugins>
</build>

4. 解决包扫描根本问题 #

移除临时添加的@ComponentScan，改为在主类显式指定扫描范围，确保覆盖所有子包：

@SpringBootApplication(scanBasePackages = "it.prenota.ticket")
@EntityScan(basePackages = "it.prenota.ticket.entity")
public class TicketApplication {
    public static void main(String[] args) {
        SpringApplication.run(TicketApplication.class, args);
    }
}

主类在根包下时默认应扫描所有子包，但如果包结构存在非直接嵌套等不规范情况，显式指定scanBasePackages可强制覆盖扫描范围。

5. 通过启动日志验证 #

查看项目启动日志，确认以下关键信息：

• 存在Entity scan: ...日志，证明实体类被成功扫描
• 存在Creating shared instance of singleton bean 'pazienteMapper'日志，证明Mapper Bean已生成
• 若开启show-sql，检查是否有Hibernate输出的建表SQL语句

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