Node与浏览器关联及browserify打包NPM模块运行报错问题咨询

核心报错原因 #

首先明确：browserify的核心作用是将CommonJS格式的NPM模块打包为浏览器可执行的JS代码，它仅对Node核心模块做了浏览器兼容子集的Polyfill，无法模拟Node环境独有的底层系统API。你遇到的两个报错本质都是模块依赖了浏览器不具备的底层能力：

• 调用require('http')/require('express')报错：browserify自带的http模块Polyfill仅实现了客户端发起请求的相关API（如http.request），完全没有服务端所需的ServerResponse、createServer等接口——浏览器本身不支持监听端口作为HTTP服务端运行，根本不存在这类能力。而Express本身是Node服务端框架，深度依赖http模块的服务端API、文件系统、进程对象等Node独有能力，天然无法在浏览器运行。
• 调用require('mysql')报错：mysql模块依赖Node的net核心模块实现TCP连接数据库的能力，而浏览器仅支持HTTP/HTTPS/WebSocket等上层传输协议，没有原生TCP Socket API，browserify的netPolyfill无法实现不存在的底层能力，因此Net.createConnection方法不存在。

问题1：解决方案 #

根据你的需求分两种场景处理：

1. 如果你是要学习测试服务端模块的逻辑：直接在Node原生环境运行代码，无需使用browserify打包。示例代码如下：

// 保存为test.js后，直接执行 node test.js 即可正常运行
const http = require('http')
const mysql = require('mysql')

// 测试http模块
const server = http.createServer((req, res) => {
  res.setHeader('Content-Type', 'text/plain')
  res.end('服务端正常运行')
})
server.listen(3000, () => {
  console.log('HTTP服务已启动，访问http://localhost:3000测试')
})

// 测试mysql连接
const connection = mysql.createConnection({
  host: 'localhost',
  user: '你的数据库用户名',
  password: '你的数据库密码',
  database: '你的库名'
})
connection.connect(err => {
  if (err) throw err
  console.log('数据库连接成功')
})

2. 如果你需要在前端页面调用相关服务能力：采用前后端分离架构，用Node原生环境运行Express、MySQL逻辑，对外暴露HTTP接口，浏览器端通过fetch/axios调用接口即可，不要尝试将服务端模块打包进前端代码。

问题2：报错根源说明 #

这类报错不是browserify导致的，本质是运行环境的能力限制。只要不是完整的Node运行环境，无论是浏览器、小程序、轻应用等其他JS运行环境，只要没有内置Node的完整http、net、文件系统等底层API，运行这些依赖Node专属能力的模块都会出现同类错误。browserify已经尽可能做了能力兼容，但受限于宿主环境的能力上限，无法模拟不存在的系统级API。

内容的提问来源于stack exchange，提问作者Richard M.