pgAdmin4启动报错：无法连接服务器及KeyError: 'ck_port_range'求助

错误现象 #

运行pgAdmin4时提示：The pgAdmin 4 server could not be contacted（无法连接pgAdmin 4服务器），日志包含以下关键错误：

2023-07-24 10:59:36,375: ERROR  pgadmin:    Database migration failed

2023-07-24 10:59:36,380: ERROR  pgadmin:    Traceback (most recent call last):
  File "C:\Users\USER\AppData\Local\Programs\pgAdmin 4\v7\python\lib\site-packages\alembic\operations\batch.py", line 692, in drop_constraint
    const = self.named_constraints.pop(const.name)
KeyError: 'ck_port_range'

...

PermissionError: [WinError 32] 另一个程序正在使用此文件，进程无法访问: 'C:\Users\USER\AppData\Roaming\pgAdmin\pgadmin4.db' -> 'C:\Users\USER\AppData\Roaming\pgAdmin\pgadmin4.db.20230724105936'

解决方案 #

• 终止占用数据库文件的进程
  打开任务管理器，找到所有与pgAdmin4、Python相关的进程，右键选择「结束任务」，彻底释放pgadmin4.db文件的占用。

• 修复或重建pgAdmin4数据库

  1. 打开路径 C:\Users\USER\AppData\Roaming\pgAdmin\（将USER替换为你的系统用户名）
  2. 备份当前的pgadmin4.db文件到其他目录，防止数据丢失
  3. 尝试恢复备份文件：如果目录下有类似pgadmin4.db.20230724105936的备份文件，将其重命名为pgadmin4.db，覆盖原文件
  4. 若没有可用备份，直接删除原pgadmin4.db文件，重启pgAdmin4后程序会自动重建干净的数据库文件（注意：此操作会丢失之前的pgAdmin配置，需要重新添加服务器连接）

• 以管理员身份启动pgAdmin4
  右键点击pgAdmin4快捷方式，选择「以管理员身份运行」，避免权限不足导致的文件访问问题。

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