升级pgAdmin 4后连接失败，如何恢复？

问题说明 #

升级pgAdmin 4后，软件无法连接服务器，弹出Fatal Error窗口，核心错误为SQLite数据库迁移时出现duplicate column name: shared异常。调整超时时间或固定端口无改善，卸载重装最新版PostgreSQL（原版本12.3）后问题仍存在。

错误日志关键内容：

Total spawn time to start the pgAdmin4 server: 0.008 Sec
2023-04-26 19:28:32,904: ERROR  pgadmin:    Database migration failed
2023-04-26 19:28:33,031: ERROR  pgadmin:    Traceback (most recent call last):
  File "C:\Users\Paul\AppData\Local\Programs\pgAdmin 4\v7\python\lib\site-packages\sqlalchemy\engine\base.py", line 1964, in _exec_single_context
self.dialect.do_execute(
  File "C:\Users\Paul\AppData\Local\Programs\pgAdmin 4\v7\python\lib\site-packages\sqlalchemy\engine\default.py", line 748, in do_execute
cursor.execute(statement, parameters)
sqlite3.OperationalError: duplicate column name: shared

解决方法 #

方法一：重置pgAdmin配置数据库 #

问题根源在pgAdmin本地的SQLite配置库，和PostgreSQL服务无关，无需重装PostgreSQL。操作步骤：

1. 关闭所有pgAdmin 4进程
2. 定位到pgAdmin配置目录：C:\Users\<你的用户名>\AppData\Roaming\pgAdmin（替换<你的用户名>为实际用户名，比如Paul）
3. 删除该目录下的pgadmin4.db文件
4. 重启pgAdmin 4，软件会自动生成新的配置数据库，之后重新添加服务器连接信息即可

方法二：彻底重装pgAdmin 4（方法一无效时使用） #

1. 卸载当前pgAdmin 4
2. 删除残留文件：
   • C:\Users\<你的用户名>\AppData\Roaming\pgAdmin
   • C:\Users\<你的用户名>\AppData\Local\Programs\pgAdmin 4
3. 下载与PostgreSQL 12.3兼容的pgAdmin版本（推荐v6.x系列，避免高版本兼容性问题）
4. 重新安装后配置服务器连接

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