Postgres搭配Liquibase+H2本地开发出现SQL语法及数据源配置错误

问题根因梳理 #

你遇到的是三个独立但关联的问题：

1. 构建阶段H2语法报错：H2数据库不支持PostgreSQL专属的CREATE EXTENSION uuid-ossp语句和gen_random_uuid()函数，两类数据库的UUID生成语法存在差异
2. 移除H2依赖后启动报错：Spring Boot启动时没有正确加载你配置的local环境配置，找不到PostgreSQL驱动和连接参数
3. 配置激活失效：你配置的local profile没有被正确触发，Spring默认按无profile状态启动，自然读不到application-local.yml的参数

分步解决方案 #

1. 解决Liquibase多数据库语法兼容问题 #

• 给Liquibase变更集增加数据库类型限制，避免PostgreSQL专属语句在H2环境执行，示例写法：

-- 仅PostgreSQL环境执行扩展安装
--changeset your_id:create_uuid_ext dbms:postgresql
CREATE EXTENSION IF NOT EXISTS uuid-ossp;

• 针对UUID生成函数做参数化适配，在不同环境配置不同的默认值：
  • 首先在SQL脚本中用占位符代替固定函数：

  CREATE TABLE your_table (
    id UUID DEFAULT ${uuid_generate_func} PRIMARY KEY,
    -- 其他字段
  );
  

  • 在PostgreSQL对应的配置文件中加参数：liquibase.parameters.uuid_generate_func=gen_random_uuid()
  • 在H2对应的配置文件中加参数：liquibase.parameters.uuid_generate_func=RANDOM_UUID()
• 如果不需要在构建阶段跑H2迁移校验，可以直接在构建配置中关闭Liquibase的运行逻辑，仅在应用启动对应环境时执行迁移。

2. 解决配置文件激活不生效问题 #

按优先级从高到低检查以下配置项：

• 检查IDE启动配置中的Active profiles是否填写了local，或者启动命令是否加了--spring.profiles.active=local参数
• 检查根目录application.yml中是否配置了默认profile：

spring:
  profiles:
    active: local

• 确认application-local.yml存放在src/main/resources目录下，没有被构建工具的过滤规则排除
• 确认application-local.yml中存在完整的数据源配置：

spring:
  datasource:
    url: jdbc:postgresql://<数据库地址>:5432/<库名>
    username: <数据库用户名>
    password: <数据库密码>
    driver-class-name: org.postgresql.Driver

3. 简化方案（可选） #

如果不需要本地用H2做单元测试/快速验证，可以直接移除H2依赖，本地开发也直接连接PostgreSQL，不需要维护两套SQL语法兼容逻辑，能大幅降低配置复杂度。

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