如何通过TerraForm升级RDS PostgreSQL实例及解决升级报错

我来逐个拆解你遇到的RDS PostgreSQL升级问题，结合背景知识和具体解决方法：

1. 无法从9.6.3升级到10.1/9.6.4的报错 #

背景知识 #

AWS RDS的PostgreSQL升级有严格的路径限制，不管是小版本还是大版本升级都不是随意跨版本的：

• 大版本升级（如9.6→10）：必须先把当前大版本的小版本升到AWS支持的最低兼容小版本（通常是该分支的最新可用小版本），不能直接从老的小版本跳级升大版本。
• 小版本升级：虽然你开启了auto_minor_version_upgrade，但这个自动升级只会在你配置的维护窗口执行，而且如果实例存在参数组不兼容、关联只读副本未同步等情况，自动升级会静默失败，不会强制执行。另外，手动指定小版本时，只能选择AWS当前支持的该大版本分支下的可用小版本，不是任意输入一个版本号都能生效。

解决方法 #

第一步：先升级到9.6分支的最新可用小版本

• 先确认AWS当前支持的PostgreSQL 9.6最新小版本：可以通过AWS控制台查看，或者执行AWS CLI命令：

  aws rds describe-db-engine-versions --engine postgres --engine-version 9.6
  

  从返回结果里找到EngineVersion字段的最新值（比如可能是9.6.24）。
• 在Terraform配置中，将engine_version设为这个9.6的最新小版本，关闭allow_major_version_upgrade（设为false），然后执行terraform apply。这一步是手动触发小版本升级，比等待自动升级更可控。

第二步：升级到PostgreSQL 10的可用版本

• 同样先确认AWS支持的PostgreSQL 10最新可用版本（比如10.23），用同样的CLI命令替换--engine-version 10即可。
• 修改Terraform配置：将engine_version设为10.x的目标版本，同时设置allow_major_version_upgrade = true，然后执行terraform apply。
• 注意：大版本升级会重启实例，期间实例会不可用，建议提前规划维护窗口；升级前务必创建RDS快照，以便出现问题时快速回滚。

2. 仅开启allow_major_version_upgrade但不修改版本号的报错 #

背景知识 #

allow_major_version_upgrade只是一个"允许大版本升级"的开关，本身不是一个独立的可修改配置项。当你只修改这个参数但不变更engine_version时，AWS API会认为你没有提交任何实际的实例修改请求，因此返回No modifications were requested的错误。

解决方法 #

• 这个开关只需要在你实际要升级大版本的时候配合engine_version的变更一起设置即可，平时不需要单独开启。如果只是想提前配置这个开关，实际上AWS不支持单独修改它，所以建议只在升级版本的同时启用这个参数。

额外注意事项 #

• 升级前请确认你的应用兼容目标PostgreSQL版本：比如9.6到10有不少语法、特性变更（如IDENTITY替代SERIAL、JSONB函数优化等），务必提前在测试环境验证。
• 如果实例有只读副本：升级主实例前，要么先升级所有副本，要么在升级主实例时配置自动升级副本（Terraform的apply_immediately参数会影响升级执行时机，按需设置）。
• 参数组兼容性：不同大版本的PostgreSQL参数组不兼容，升级后需要将实例关联到对应版本的参数组（可以用默认参数组，也可以提前创建自定义参数组），在Terraform中通过parameter_group_name配置。

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