Svelte应用本地PostgreSQL连接字符串无法正常工作问题排查

核心问题定位 #

从报错信息看，应用在尝试连接127.0.0.1:443和**::1:443**（HTTPS端口），但本地PostgreSQL监听的是5432端口，且报错来自ws（WebSocket库）。这说明你大概率用了Vercel Postgres专属客户端库（比如@vercel/postgres）连接本地数据库——该库默认适配Vercel托管的Postgres服务，强制走WebSocket/HTTPS协议，和本地PostgreSQL的TCP连接协议不兼容。

具体排查步骤 #

• 检查项目依赖：确认是否安装了@vercel/postgres或其他Vercel专属Postgres客户端。如果是，本地开发需改用标准PostgreSQL客户端，比如pg（node-postgres）。
• 替换客户端代码：
  错误的Vercel客户端示例：

  import { sql } from '@vercel/postgres';
  const result = await sql`SELECT * FROM table`;
  

  改用pg客户端的正确示例：

  import { Pool } from 'pg';
  const pool = new Pool({
    connectionString: process.env.POSTGRES_URL
  });
  const result = await pool.query('SELECT * FROM table');
  

• 验证环境变量：在代码中添加console.log(process.env.POSTGRES_URL)，确认连接字符串是否正确加载、未被其他逻辑覆盖。
• 检查PostgreSQL配置：
  • 打开postgresql.conf，确认listen_addresses设为*或localhost，允许本地TCP连接；
  • 检查pg_hba.conf，确保允许你的数据库用户（如myusername）从localhost地址连接。
• 重启开发服务器：修改.env.local或依赖后，必须重启Svelte服务，否则环境变量不会生效。

额外验证方案 #

在项目根目录新建test-db.js文件，用pg客户端直接测试连接：

const { Pool } = require('pg');
const pool = new Pool({
  connectionString: process.env.POSTGRES_URL
});
pool.query('SELECT NOW()', (err, res) => {
  if (err) console.error(err);
  else console.log('连接成功:', res.rows[0]);
  pool.end();
});

执行node test-db.js，若能正常返回当前时间，说明连接字符串和本地数据库无问题，问题完全出在应用使用的客户端库上。

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