Cloudflare Workers连接Azure PostgreSQL时pg-native无法解析的求助

你遇到的问题核心是Cloudflare Workers边缘环境不支持Node.js原生模块（如pg-native），默认的pg包会尝试加载原生客户端，最终导致打包失败。下面是几个可行的解决方法：

方法一：强制使用pg的纯JavaScript客户端 #

直接导入pg库中的纯JS客户端实现，绕开原生模块的加载逻辑，彻底消除对pg-native的依赖：

// 直接导入纯JS版本的Client，避免触发原生模块加载
const { Client } = require('pg/lib/client');

addEventListener('fetch', event => {
  event.respondWith(handleRequest(event.request))
})

async function handleRequest(request) {
  const client = new Client({
    user: 'XXX',
    host: 'XXX',
    database: 'XXX',
    password: 'XXX',
    port: 5432,
    ssl: true // Azure PostgreSQL强制要求SSL连接，必须添加
  });

  try {
    await client.connect();
    const res = await client.query('SELECT * from XXX');
    return new Response(res.rows[0].message);
  } catch (err) {
    return new Response(`数据库连接错误: ${err.message}`, { status: 500 });
  } finally {
    // 确保无论成功失败都关闭连接
    await client.end();
  }
}

方法二：使用适配边缘环境的PostgreSQL客户端 #

推荐使用@neondatabase/serverless，这是专门为Cloudflare Workers、Vercel Edge Functions等边缘环境设计的纯JS PostgreSQL客户端，无需依赖原生模块，兼容性更好：

1. 安装依赖：

npm install @neondatabase/serverless

2. 修改代码：

const { Client } = require('@neondatabase/serverless');

addEventListener('fetch', event => {
  event.respondWith(handleRequest(event.request))
})

async function handleRequest(request) {
  // 直接使用Azure提供的完整连接字符串，记得加上sslmode=require
  const client = new Client('postgresql://user:password@host:5432/database?sslmode=require');

  try {
    await client.connect();
    const res = await client.query('SELECT * from XXX');
    return new Response(res.rows[0].message);
  } catch (err) {
    return new Response(`数据库连接错误: ${err.message}`, { status: 500 });
  } finally {
    await client.end();
  }
}

为什么pg-native不可行？ #

Cloudflare Workers运行在基于V8的边缘环境中，不支持Node.js的require()加载原生C/C++模块（如pg-native），而且esbuild这类打包工具也无法将原生模块打包进Worker代码里，所以这条路走不通。

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