Google Cloud SQL中PostgreSQL 11实例升级至15失败求助

核心背景梳理 #

• 环境：Google Cloud SQL PostgreSQL 11 企业标准版，仅安装citext、dblink扩展
• 操作：克隆主实例后升级至PostgreSQL 15，多次失败
• 异常日志：
  1. user=cloudsqladmin ERROR: function postgis_full_version() does not exist at character 8
  2. db=cloudsqladmin,user=cloudsqladmin FATAL: terminating connection due to administrator command
• 矛盾点：开发环境同版本升级成功；新建PostgreSQL 12实例升级至15时，出现相同日志但升级成功；手动安装postgis后仍报错

排查步骤 #

1. 检查克隆实例的元数据残留 #

Cloud SQL克隆可能遗留系统级元数据，需重点确认：

• 查询cloudsqladmin数据库中是否存在PostGIS相关残留对象：

  SELECT proname FROM pg_proc WHERE proname LIKE '%postgis%';
  

  若存在非业务依赖的相关条目，手动删除
• 对比主实例与克隆实例的postgresql.conf参数，重点检查shared_preload_libraries、search_path，确认是否有PostGIS相关预加载配置残留

2. 验证扩展兼容性与状态 #

虽然仅安装了citext和dblink，仍需确认：

• 查看扩展版本是否符合PostgreSQL 15兼容要求：

  SELECT extname, extversion FROM pg_extension;
  

• 尝试卸载重装扩展后再执行升级：

  DROP EXTENSION IF EXISTS citext;
  DROP EXTENSION IF EXISTS dblink;
  CREATE EXTENSION citext;
  CREATE EXTENSION dblink;
  

3. 排查克隆操作导致的异常 #

由于开发环境直接升级成功，克隆可能是问题诱因：

• 尝试直接对非克隆的PostgreSQL 11测试实例执行升级，验证是否为克隆操作导致的元数据异常
• 查看实例历史操作记录，确认是否曾有安装/卸载PostGIS的操作残留

4. 启用详细升级日志 #

默认日志未展示完整错误，需开启详细日志定位：

• 在Cloud SQL控制台将实例的log_min_messages设为debug1，log_statement设为all
• 重新执行升级，收集完整日志，重点查找postgis_full_version()错误之后的中断信息

5. 获取内部升级日志 #

若以上步骤无法定位，可通过官方支持获取托管环境内部日志：

• 提交Google Cloud支持工单，提供实例ID、升级失败时间戳，请求获取完整升级执行日志，排查脚本中断的具体阶段

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