.NET使用Npgsql连接PostgreSQL时出现XX000错误求助

排查与修复步骤 #

• 重新核对连接字符串的端口配置
  哪怕你已经验证过，再仔细确认连接字符串里的端口字段写法是否标准，正确格式示例：

  Host=your_server_ip;Port=6543;Database=target_db;Username=db_user;Password=db_pass;
  

  重点检查Port的拼写是否正确，数值是否确实为6543——避免拼写错误（比如写成Ports或PortNumber）导致的隐性配置失效。

• 升级Npgsql NuGet包到稳定版
  部分旧版Npgsql在处理非默认端口的连接时存在兼容性问题，直接升级到最新稳定版，排除版本层面的bug。

• 检查网络与防火墙规则
  PGAdmin能连接不代表.NET应用的网络通路完全一致：

  • 确认应用所在机器的防火墙允许出站访问6543端口；
  • 检查PostgreSQL服务器的pg_hba.conf，确保添加了允许应用IP通过6543端口连接的规则（有些配置仅针对默认5432端口开放权限）。

• 验证PostgreSQL的监听配置
  查看服务器端的postgresql.conf：

  • 确认listen_addresses包含应用的IP地址（或者设为*允许所有IP访问）；
  • 确认port参数设置为6543，或者服务器启动时通过-p 6543指定了正确端口。

• 提取详细错误日志
  在.NET代码中捕获完整的异常堆栈，同时查看PostgreSQL服务器的pg_log目录下的日志文件——DbHandler Exited通常是表层错误，服务器日志里会有更具体的触发原因，比如连接初始化时的资源分配失败、权限不足等。

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