Debian环境重启后PGAdmin无法连接PostgreSQL的排查求助

先纠正你当前配置文件的语法错误：PGAdmin的Python配置文件需统一使用等号赋值，且不能包含HTML的<br>标签，你现有的写法会导致配置完全不生效。正确的配置格式如下：

PGADMIN_CONFIG_ENHANCED_COOKIE_PROTECTION = False
PGADMIN_CONFIG_WTF_CSRF_CHECK_DEFAULT = False
PGADMIN_CONFIG_WTF_CSRF_ENABLED = False

接下来按以下步骤逐步排查：

• 重启PGAdmin服务：修改配置后必须重启服务才能生效，Debian环境下执行命令：

  sudo systemctl restart pgadmin4
  

  重启后再尝试连接PostgreSQL服务器。

• 清除浏览器缓存与Cookie：登录PGAdmin成功但操作时触发CSRF报错，大概率是浏览器缓存了旧会话数据。清空PGAdmin对应域名的Cookie，或直接用无痕模式打开PGAdmin测试。

• 检查PGAdmin会话目录权限：PGAdmin依赖会话目录存储临时数据，权限异常会导致Token无法生成或读取。默认会话目录为/var/lib/pgadmin4/sessions/，执行以下命令修复权限：

  sudo chown -R www-data:www-data /var/lib/pgadmin4/sessions/
  sudo chmod -R 700 /var/lib/pgadmin4/sessions/
  

  修改完成后再次重启PGAdmin服务。

• 验证PostgreSQL连接参数：虽然ODBC能正常连接，但重启机器后PostgreSQL的监听配置可能出现变动：

  1. 检查postgresql.conf中的listen_addresses是否包含PGAdmin所在机器的IP，port是否为默认的5432；
  2. 检查pg_hba.conf中是否允许PGAdmin机器的IP连接（例如添加规则：host all all <PGAdmin_IP>/32 scram-sha-256）；
  3. 修改后重启PostgreSQL服务：

     sudo systemctl restart postgresql
     

• 查看完整日志信息：除了/var/log/pgadmin/pgadmin4.log，若PGAdmin使用反向代理（如Nginx/Apache），还需查看对应Web服务器的日志，里面可能包含更详细的请求错误细节，帮助定位CSRF问题的根源。

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