针对你遇到的情况，以下是需要排查和补充的步骤：

1. 确认升级脚本是否存在 #

PostgreSQL扩展升级依赖增量脚本，你需要检查目标PostgreSQL实例的share/extension目录（通常路径为C:\Program Files\PostgreSQL\17\share\extension）是否包含以下文件：

• timescaledb.control（版本应为2.20.3）
• 所有从2.18.0到2.20.3的增量升级脚本，比如：
  • timescaledb--2.18.0--2.19.0.sql
  • timescaledb--2.19.0--2.20.0.sql
  • timescaledb--2.20.0--2.20.3.sql

如果这些文件缺失，说明TimescaleDB的安装程序未将脚本部署到正确的PostgreSQL实例目录。你可以手动从TimescaleDB v2.20.3安装包的share/extension目录中复制这些文件到目标路径（操作前请停止PostgreSQL服务）。

2. 验证安装程序的目标实例 #

运行TimescaleDB setup.exe时，务必确认选择的是PostgreSQL 17.0的正确安装路径。如果你的机器上存在多个PostgreSQL版本，很可能误将新版本安装到了其他实例目录下，导致当前使用的PostgreSQL 17并未加载新的扩展脚本。

3. 检查依赖扩展的升级状态 #

如果你同时安装了timescaledb_toolkit等依赖扩展，需要先将这些依赖升级到与TimescaleDB v2.20.3兼容的版本，再执行主扩展的升级：

ALTER EXTENSION timescaledb_toolkit UPDATE;
-- 之后再执行主扩展升级
ALTER EXTENSION timescaledb UPDATE TO VERSION '2.20.3';

4. 查看PostgreSQL日志排查错误 #

执行升级命令后，查看PostgreSQL的日志文件（位于C:\Program Files\PostgreSQL\17\data\log目录），日志中会明确记录升级失败的原因（比如脚本缺失、权限不足、依赖冲突等），这是定位问题的关键依据。

5. 手动替换所有TimescaleDB相关文件 #

停止PostgreSQL服务后，除了替换lib目录下的timescaledb.dll，还要确保：

• share/extension下的所有timescaledb文件都替换为2.20.3版本
• bin目录下的timescaledb相关工具（如timescaledb-tune.exe）也更新为对应版本

替换完成后重新启动服务，再次执行升级命令。

6. 确认数据库级别的扩展状态 #

执行以下SQL查询，查看扩展的详细信息：

SELECT extname, extversion, extrelocatable FROM pg_extension WHERE extname = 'timescaledb';

如果extversion仍为2.18.0，且日志中无报错，尝试退出psql重新连接后再执行\dx查看，有时客户端会缓存旧版本信息。

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