Spring Boot 2.1.1整合PostgreSQL OAuth2时表访问异常求助

我之前也碰到过几乎一模一样的问题，折腾了好一阵子才捋清楚根源，给你梳理下可能的原因和对应的解决办法：

核心原因分析 #

本质上是Spring Security OAuth2的JDBC组件没有正确关联PostgreSQL的public schema，即使你设置了用户搜索路径，也可能因为数据源配置、SQL模板默认值或者初始化脚本的问题导致识别失败。

具体解决步骤 #

1. 显式配置数据源的默认Schema #

OAuth2的JDBC客户端（比如JdbcClientDetailsService）是直接基于JDBC操作的，不会自动继承Hibernate的schema配置，所以必须在数据源层面强制指定public schema：

方式一：在JDBC URL中添加schema参数

修改你的application.yml或application.properties：

spring:
  datasource:
    url: jdbc:postgresql://localhost:5432/your_database?currentSchema=public
    username: your_username
    password: your_password

方式二：通过连接池配置指定Schema

如果你用的是HikariCP（Spring Boot默认连接池），可以直接配置schema属性：

spring:
  datasource:
    hikari:
      schema: public

2. 优化初始化脚本，避免手动加前缀 #

不用在每个表名前加public.，而是在schema.sql开头添加一行切换schema的命令：

SET search_path TO public;

-- 接下来正常写建表语句即可
CREATE TABLE oauth_client_details (
    client_id VARCHAR(256) PRIMARY KEY,
    client_secret VARCHAR(256),
    scope VARCHAR(256),
    authorized_grant_types VARCHAR(256),
    web_server_redirect_uri VARCHAR(256),
    authorities VARCHAR(256),
    access_token_validity INTEGER,
    refresh_token_validity INTEGER,
    additional_information VARCHAR(4096),
    autoapprove VARCHAR(256)
);

3. 自定义OAuth2客户端SQL模板（如果前两步无效） #

有些版本的Spring Security OAuth2可能存在默认SQL未适配schema的问题，这时候需要手动覆盖JdbcClientDetailsService的查询语句：

import org.springframework.security.oauth2.provider.client.JdbcClientDetailsService;
import org.springframework.context.annotation.Bean;
import javax.sql.DataSource;

@Configuration
public class OAuth2Config {

    @Bean
    public ClientDetailsService clientDetailsService(DataSource dataSource) {
        JdbcClientDetailsService clientDetailsService = new JdbcClientDetailsService(dataSource);
        // 覆盖默认查询语句，指定public schema
        clientDetailsService.setFindClientDetailsSql(
            "SELECT client_id, client_secret, scope, authorized_grant_types, web_server_redirect_uri, authorities, access_token_validity, refresh_token_validity, additional_information, autoapprove " +
            "FROM public.oauth_client_details WHERE client_id = ?"
        );
        // 按需覆盖其他SQL（比如插入、更新语句）
        return clientDetailsService;
    }
}

4. 验证PostgreSQL用户的默认Schema #

确认你的数据库用户默认schema是public：

1. 登录pgAdmin，执行SQL：

   SELECT current_schema();
   

2. 如果返回不是public，修改用户的默认schema：

   ALTER USER your_username SET search_path TO public;
   

3. 重启你的Spring Boot应用，让新的schema设置生效。

验证方法 #

启动应用后，查看日志中的SQL语句，确认所有OAuth2相关的查询都指向public.oauth_client_details（或其他对应表）；也可以在pgAdmin中检查public schema下是否存在对应的表，并且数据正确。

内容的提问来源于stack exchange，提问作者Andrew Scott Evans