新装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

