Spring无法连接Supabase/Neon数据库：FATAL: Tenant or user not found

开发后端应用时，尝试连接Supabase/Neon数据库，已在application.properties中配置正确的数据库信息（URL、用户名、密码），但Spring应用运行时抛出错误：

unable to obtain isolated JDBC connection [FATAL: Tenant or user not found]

已确认：

• 通过IntelliJ内置数据库工具、pgAdmin均可正常连接目标数据库
• 朋友创建的极简Spring项目在他的环境中可正常连接，但我下载后未修改任何配置，运行仍报相同错误
• 已尝试重装IntelliJ、清理缓存、更换为社区版，问题依旧

排查步骤与解决方案 #

1. 检查配置覆盖问题 #

Spring会优先读取环境变量或JVM参数，可能覆盖application.properties中的配置：

• 打开IntelliJ运行配置，查看环境变量列表，删除或修正SPRING_DATASOURCE_URL、SPRING_DATASOURCE_USERNAME、SPRING_DATASOURCE_PASSWORD这类可能存在的变量
• 检查JVM启动参数，移除-Dspring.datasource.*开头的自定义参数

2. 验证实际加载的配置 #

在应用启动类中添加代码，打印Spring实际加载的数据源配置，确认是否和预期一致：

import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.CommandLineRunner;
import org.springframework.stereotype.Component;

@Component
public class ConfigValidator implements CommandLineRunner {
    @Value("${spring.datasource.url}")
    private String dbUrl;
    @Value("${spring.datasource.username}")
    private String dbUsername;

    @Override
    public void run(String... args) {
        System.out.println("实际加载的DB URL: " + dbUrl);
        System.out.println("实际加载的DB用户名: " + dbUsername);
    }
}

3. 核对JDBC URL格式 #

确保URL符合Supabase/Neon的要求：

• Supabase格式示例：

  jdbc:postgresql://db.<项目ID>.supabase.co:5432/postgres?user=<用户名>&password=<密码>&sslmode=require
  

• Neon格式示例：

  jdbc:postgresql://<主机名>:5432/<数据库名>?user=<用户名>&password=<密码>&sslmode=require
  

注意必须包含sslmode=require参数，且URL中的租户/用户标识与数据库工具中使用的完全一致。

4. 排查网络与代理问题 #

• 关闭本地代理工具，避免连接请求被拦截或篡改
• 检查防火墙设置，确保允许应用访问5432端口
• 切换网络环境（如从公司内网换为个人热点），排除网络限制

5. 检查依赖兼容性 #

确认Spring Boot与PostgreSQL驱动版本匹配：

• 查看pom.xml或build.gradle中的postgresql依赖，使用Spring Boot官方推荐的配套版本，例如：

<!-- Maven示例 -->
<dependency>
    <groupId>org.postgresql</groupId>
    <artifactId>postgresql</artifactId>
    <version>42.6.0</version>
</dependency>

6. 清理依赖缓存 #

本地依赖缓存损坏可能导致驱动加载异常：

• Maven执行：mvn clean install -U
• Gradle执行：./gradlew clean build --refresh-dependencies

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