使用Parcel打包Web应用时遇pg-cloudflare导出CloudflareSocket错误

问题根源 #

pg库新增了pg-cloudflare作为可选依赖，用于Cloudflare环境的Socket实现，但Parcel在打包时错误引入了它的空实现文件（empty.js），该文件未导出CloudflareSocket，从而导致构建失败。

修复步骤 #

1. 强制pg使用Node原生Socket，绕过pg-cloudflare #

修改Sequelize配置，明确指定pg模块并强制使用原生Socket：

const { Sequelize } = require('sequelize');
const pg = require('pg');

// 覆盖pg的Socket实现，强制使用Node原生net.Socket
pg.Client.prototype._getSocket = function() {
  return require('net').Socket;
};

const sequelize = new Sequelize('your_db_name', 'your_username', 'your_password', {
  host: 'localhost',
  dialect: 'postgres',
  dialectModule: pg,
  dialectOptions: {
    // 根据你的PostgreSQL环境调整，生产环境可能需要开启SSL
    ssl: process.env.NODE_ENV === 'production'
  }
});

2. 配置Parcel排除pg-cloudflare依赖 #

在项目根目录创建或修改.parcelrc，添加别名规则排除pg-cloudflare：

{
  "resolvers": [
    "@parcel/resolver-default",
    {
      "resolve": {
        "alias": {
          "pg-cloudflare": false
        }
      }
    }
  ]
}

也可在package.json中设置别名：

{
  "alias": {
    "pg-cloudflare": "./empty-mock.js"
  }
}

然后创建empty-mock.js文件：

// 空模块，避免Parcel解析pg-cloudflare的错误导出
module.exports = {};

3. 降级pg库版本 #

若上述方法无效，可降级pg到未引入pg-cloudflare的稳定版本，比如8.11.x系列：

npm uninstall pg
npm install pg@8.11.3

4. 架构优化（纯前端场景） #

如果是纯前端项目，禁止直接在前端代码中连接PostgreSQL——这既存在安全风险，也不符合前端架构规范。应搭建后端API服务，前端通过API与数据库交互，彻底避免在前端打包时引入Node.js数据库模块。

内容的提问来源于stack exchange，提问作者Adrián Leiva