Windows 10环境下pgAdmin 4无限加载问题求助

问题场景 #

在Windows 10系统中安装PostgreSQL 14后，打开pgAdmin4时界面一直停留在“Loading pgAdmin4...”状态，无法完成加载。更换为PostgreSQL 15版本后问题依旧，尝试修改注册表HKEY_CLASSES_ROOT\.js项添加Content Type=text/javascript和ContentType=text/javascript配置也未解决问题。

可行解决方法 #

1. 清理pgAdmin4缓存 #

• 打开文件资源管理器，输入路径：%APPDATA%\pgAdmin
• 删除pgAdmin4.db文件和storage文件夹
• 重新启动pgAdmin4

2. 检查Python运行环境（pgAdmin4依赖Python） #

• 打开命令提示符（CMD），输入python --version或py --version，确认系统已安装Python 3.8及以上版本（pgAdmin4 16+要求Python 3.8+）
• 若未安装，前往Python官网下载对应版本安装，安装时勾选“Add Python to PATH”
• 若已安装但版本不符，升级Python到符合要求的版本

3. 修改pgAdmin4配置文件调整端口 #

• 找到pgAdmin4的配置文件，默认路径：C:\Program Files\PostgreSQL\<版本号>\pgAdmin 4\web\config.py
• 打开文件，找到DEFAULT_SERVER_PORT = 5050（默认端口可能是5050），修改为未被占用的端口（比如5051）
• 保存文件后，重启pgAdmin4服务或重新打开pgAdmin4

4. 重置pgAdmin4服务 #

• 按下Win+R，输入services.msc回车打开“服务”面板
• 找到pgAdmin4服务，右键选择“停止”，等待几秒后右键选择“启动”
• 重新打开pgAdmin4

5. 以管理员身份运行pgAdmin4 #

• 找到pgAdmin4的快捷方式，右键选择“以管理员身份运行”
• 验证是否能正常加载界面

6. 排查防火墙或安全软件拦截 #

• 临时关闭Windows Defender防火墙或第三方安全软件
• 重新启动pgAdmin4，测试是否能正常加载
• 若恢复正常，在防火墙中添加pgAdmin4的允许通行规则

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