Spring Boot启动报错：SPRING_SESSION表不存在问题求助

一、user表无法创建的原因 #

PostgreSQL中user是保留关键字，直接用作表名会触发语法错误，改成users避开关键字即可正常创建，属于预期行为。

二、SPRING_SESSION表无法自动创建的核心排查点 #

1. 检查Spring Session自动配置开关 #

确保application.properties未禁用自动建表：

# Spring Boot 2.3及以下版本用这个配置，设为always强制初始化表结构
spring.session.jdbc.initialize-schema=always

# Spring Boot 2.4+版本用这个配置，确保未被注释或覆盖
spring.session.jdbc.schema=classpath:org/springframework/session/jdbc/schema-postgresql.sql

2. 验证数据库用户权限 #

自动建表失败常因权限不足，给数据库用户赋予建表权限：

-- 给目标用户赋予数据库的创建权限
GRANT CREATE ON DATABASE your_db_name TO your_db_user;

测试阶段可直接赋予全权限（生产环境谨慎操作）：

GRANT ALL PRIVILEGES ON DATABASE your_db_name TO your_db_user;

3. 核对数据源配置 #

确认application.properties中数据源信息完全正确，连接的是目标数据库实例：

spring.datasource.url=jdbc:postgresql://localhost:5432/your_db_name
spring.datasource.username=your_username
spring.datasource.password=your_password
spring.datasource.driver-class-name=org.postgresql.Driver

若有多数据源配置，需确保Spring Session绑定的是正确数据源。

4. 手动执行建表脚本测试 #

直接运行Spring Session官方提供的PostgreSQL建表脚本，验证是否能成功创建：

CREATE TABLE SPRING_SESSION (
	PRIMARY_ID CHAR(36) NOT NULL,
	SESSION_ID CHAR(36) NOT NULL,
	CREATION_TIME BIGINT NOT NULL,
	LAST_ACCESS_TIME BIGINT NOT NULL,
	MAX_INACTIVE_INTERVAL INT NOT NULL,
	EXPIRY_TIME BIGINT NOT NULL,
	PRINCIPAL_NAME VARCHAR(100),
	CONSTRAINT SPRING_SESSION_PK PRIMARY KEY (PRIMARY_ID)
);

CREATE UNIQUE INDEX SPRING_SESSION_IX1 ON SPRING_SESSION (SESSION_ID);
CREATE INDEX SPRING_SESSION_IX2 ON SPRING_SESSION (EXPIRY_TIME);
CREATE INDEX SPRING_SESSION_IX3 ON SPRING_SESSION (PRINCIPAL_NAME);

CREATE TABLE SPRING_SESSION_ATTRIBUTES (
	SESSION_PRIMARY_ID CHAR(36) NOT NULL,
	ATTRIBUTE_NAME VARCHAR(200) NOT NULL,
	ATTRIBUTE_BYTES BYTEA NOT NULL,
	CONSTRAINT SPRING_SESSION_ATTRIBUTES_PK PRIMARY KEY (SESSION_PRIMARY_ID, ATTRIBUTE_NAME),
	CONSTRAINT SPRING_SESSION_ATTRIBUTES_FK FOREIGN KEY (SESSION_PRIMARY_ID) REFERENCES SPRING_SESSION(PRIMARY_ID) ON DELETE CASCADE
);

若手动执行报错，根据错误信息直接定位问题（如语法冲突、权限不足）。

5. 检查版本兼容性 #

确保Spring Boot与Spring Session版本匹配，避免版本冲突导致自动配置失效。示例pom.xml配置：

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.2.0</version> <!-- 按需调整为你的项目版本 -->
    <relativePath/>
</parent>

<dependencies>
    <!-- Spring Session JDBC依赖，版本由parent统一管理 -->
    <dependency>
        <groupId>org.springframework.session</groupId>
        <artifactId>spring-session-jdbc</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-jdbc</artifactId>
    </dependency>
    <dependency>
        <groupId>org.postgresql</groupId>
        <artifactId>postgresql</artifactId>
        <scope>runtime</scope>
    </dependency>
</dependencies>

6. 排查自定义配置覆盖 #

若项目中存在自定义SessionRepository或相关配置类，可能覆盖了自动建表逻辑。检查是否有类似代码：

@Configuration
public class CustomSessionConfig {
    @Bean
    public SessionRepository<?> sessionRepository() {
        // 自定义实现可能跳过自动建表
    }
}

如有，需手动添加建表逻辑，或移除自定义配置改用默认自动配置。

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