Spring Boot R2DBC WebFlux操作PostgreSQL内置方法报SQL语法错误

问题根源 #

Spring Data R2DBC默认的表名映射规则是将实体类名转换为蛇形小写格式（比如实体类Volunteer会默认映射到volunteer表），但你的数据库实际表名是Volunteers（首字母大写且为复数形式），导致Repository内置方法生成的SQL找不到对应表，触发BadSqlGrammarException。而自定义@Query可以正常工作，是因为你在自定义查询里指定了正确的表名。

解决办法 #

方法1：给实体类指定表名（最直接） #

在Volunteer实体类上添加@Table注解，明确指定数据库中的表名：

import org.springframework.data.relational.core.mapping.Table;

@Table("Volunteers")
public class Volunteer {
    private Long id;
    private String username;
    private String password;
    private String role;
    private Boolean active;

    // 添加上getter、setter方法，或使用Lombok简化代码
}

修改后，Spring Data R2DBC生成SQL时会使用指定的Volunteers表名，内置方法就能正常执行。

方法2：全局配置表名映射策略（适合多实体场景） #

如果你的项目中有多个实体类需要统一映射到复数形式的表名，可以自定义命名策略。创建一个配置类：

import org.springframework.data.r2dbc.mapping.R2dbcMappingContext;
import org.springframework.data.relational.core.mapping.NamingStrategy;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class R2dbcConfig {
    @Bean
    public R2dbcMappingContext r2dbcMappingContext(NamingStrategy namingStrategy) {
        R2dbcMappingContext context = new R2dbcMappingContext();
        context.setNamingStrategy(namingStrategy);
        return context;
    }

    @Bean
    public NamingStrategy customNamingStrategy() {
        return new NamingStrategy() {
            @Override
            public String getTableName(Class<?> type) {
                // 将实体类名转为首字母大写的复数形式
                String className = type.getSimpleName();
                return className + "s";
            }
        };
    }
}

这种方式无需给每个实体单独加@Table注解，适合有统一表名规则的项目。

额外注意点 #

如果后续遇到字段映射问题（比如数据库列名是蛇形full_name，实体类字段是驼峰fullName），可以通过@Column注解指定列名，或者在全局命名策略中配置驼峰转蛇形的规则。

内容的提问来源于stack exchange，提问作者Karol Wilczyński