You need to enable JavaScript to run this app. 新装pgAdmin4启动后卡在加载界面 日志显示后台服务已正常启动
优惠活动
大模型
产品
解决方案
定价
更多

新装pgAdmin4启动后卡在加载界面 日志显示后台服务已正常启动

pgAdmin4 后端启动正常但卡在加载界面的解决方案

用户在个人笔记本安装PostgreSQL 13附带的pgAdmin4后,启动应用始终停留在加载界面无法进入操作页。从运行日志判断,pgAdmin4的本地后端服务已经完成启动、正常监听本地端口、生成了合法的访问密钥,日志层面标记服务启动成功,但前端页面始终无法完成加载渲染。

运行日志原文:

2020-11-14 00:22:46: Checking for system tray...
2020-11-14 00:22:46: Starting pgAdmin4 server...
2020-11-14 00:22:46: Creating server object, port:64222, key:2a079549-63da-44d2-8931-efa9de3a847f, logfile:C:/Users/yonis/AppData/Local/pgadmin4.d41d8cd98f00b204e9800998ecf8427e.log
2020-11-14 00:22:46: Python Path: C:/Program Files/PostgreSQL/13/pgAdmin 4/venv/Lib/site-packages;C:/Program Files/PostgreSQL/13/pgAdmin 4/venv/DLLs;C:/Program Files/PostgreSQL/13/pgAdmin 4/venv/Lib
2020-11-14 00:22:46: Python Home: C:/Program Files/PostgreSQL/13/pgAdmin 4/venv
2020-11-14 00:22:46: Initializing Python...
2020-11-14 00:22:46: Python initialized.
2020-11-14 00:22:46: Adding new additional path elements
2020-11-14 00:22:46: Redirecting stderr...
2020-11-14 00:22:46: stderr redirected successfully.
2020-11-14 00:22:46: Initializing server...
2020-11-14 00:22:46: Webapp Path: C:/Program Files/PostgreSQL/13/pgAdmin 4/web/pgAdmin4.py
2020-11-14 00:22:46: Server initialized, starting server thread...
2020-11-14 00:22:46: Open the application code and run it.
2020-11-14 00:22:46: Set the port number, key and force SERVER_MODE off
2020-11-14 00:22:46: PyRun_SimpleFile launching application server...
2020-11-14 00:22:47: Application Server URL: http://127.0.0.1:64222/?key=2a079549-63da-44d2-8931-efa9de3a847f
2020-11-14 00:22:47: The server should be up. Attempting to connect and get a response.
2020-11-14 00:22:53: Attempt to connect one more time in case of a long network timeout while looping
2020-11-14 00:22:53: Everything works fine, successfully started pgAdmin4.

排查解决步骤

  • 内置渲染引擎兼容问题
    pgAdmin4桌面端内置了Web渲染组件实现界面展示,PostgreSQL13自带的旧版pgAdmin4对Windows 10/11的新Chromium内核存在适配bug,会出现静态资源执行阻塞、永远停留在加载动画的情况。
    验证方式:复制日志里输出的访问地址http://127.0.0.1:64222/?key=2a079549-63da-44d2-8931-efa9de3a847f,粘贴到系统原生Chrome/Edge浏览器中访问,如果能正常打开pgAdmin的操作界面,即可确认是内置渲染引擎的适配问题。对应的解决方式为升级pgAdmin4到最新稳定版,或在系统默认应用设置中,将Web内容的默认打开方式关联为Chrome/Edge,替换pgAdmin的内置渲染调用。

  • 本地配置缓存损坏
    pgAdmin4会在用户目录下存储个人配置、临时缓存文件,如果之前出现过程序异常退出、强制结束进程的情况,很容易造成缓存文件损坏,导致前端初始化逻辑卡住。
    操作方式:打开文件资源管理器,定位到C:\Users\当前登录用户名\AppData\Roaming\pgAdmin路径,将该文件夹重命名为pgAdmin_config_backup,重新启动pgAdmin4,程序会自动生成全新的配置目录,再观察加载是否正常。

  • 本地回环请求被拦截
    前端页面加载时需要向127.0.0.1的本地后端发送初始化请求,如果系统配置了全局代理、第三方防火墙/安全软件拦截了本地回环地址的请求,就会造成接口请求超时,页面一直停留在加载状态。
    操作方式:临时关闭系统全局代理、第三方安全软件的网络拦截规则,确认hosts文件中没有将127.0.0.1指向其他地址的错误配置,再重启pgAdmin4测试。

  • 端口占用异常
    即便日志显示服务绑定端口成功,如果对应端口被其他残留进程劫持,前端的请求会被转发到错误的服务进程,拿到非预期的响应内容,无法正常渲染界面。
    操作方式:以管理员身份打开命令提示符,执行命令netstat -ano | findstr "64222",核对端口对应的进程ID是否属于pgAdmin4主程序,若存在其他进程占用端口,结束占用进程后重启pgAdmin4即可。

内容的提问来源于stack exchange,提问作者Yonis Mohamoud

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.18 09:54:08