Spring Boot配置PostgreSQL时出现未使用属性问题如何解决？

可能原因及修复步骤 #

1. 确认依赖引入正确性 #

确保pom.xml中包含完整的Spring Data JPA starter和PostgreSQL驱动，而非仅单独的JPA API依赖：

<dependencies>
    <!-- Spring Web Starter -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <!-- Spring Data JPA Starter -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>
    <!-- PostgreSQL驱动 -->
    <dependency>
        <groupId>org.postgresql</groupId>
        <artifactId>postgresql</artifactId>
        <scope>runtime</scope>
    </dependency>
</dependencies>

仅引入javax.persistence-api这类API依赖会导致Spring Boot自动配置不生效，进而标记属性未使用。

2. 处理IDE静态检查误报 #

IDE的静态分析偶尔会出现误报，可通过以下操作解决：

• 执行Maven命令同步依赖：mvn clean install -U
• 重启IDE并重新加载项目（如IntelliJ IDEA中选择File → Reload All Maven Projects）
• 关闭并重新打开application.properties文件

3. 核对配置属性拼写 #

确保配置键名严格符合Spring Boot规范，注意大小写：

• 正确写法：spring.datasource.url、spring.jpa.hibernate.ddl-auto
• 避免拼写错误，比如spring.dataSource.url（大小写错误）

4. 检查自定义数据源配置冲突 #

如果项目中存在自定义的DataSource或EntityManagerFactory Bean，Spring Boot自动配置会被禁用，此时需手动注入配置属性：

@Configuration
public class DataSourceConfig {

    @Value("${spring.datasource.url}")
    private String dbUrl;

    @Value("${spring.datasource.username}")
    private String dbUsername;

    @Value("${spring.datasource.password}")
    private String dbPassword;

    @Bean
    public DataSource dataSource() {
        return DataSourceBuilder.create()
                .url(dbUrl)
                .username(dbUsername)
                .password(dbPassword)
                .driverClassName("org.postgresql.Driver")
                .build();
    }
}

5. 验证版本兼容性 #

确保Spring Boot、Java 17和PostgreSQL驱动版本匹配：

• Spring Boot 3.x 完全支持Java 17，搭配PostgreSQL驱动42.5+版本
• Spring Boot 2.x需升级至2.7.x版本才能兼容Java 17

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