报错TypeError: Net.connect is not a function，附代码及依赖配置

错误根源 #

你项目中安装了第三方的net和tls包，但Node.js本身内置了同名的核心模块。mysql2创建连接时依赖Node.js内置net模块的connect方法，而第三方net包未提供该方法，因此触发TypeError。

解决方案 #

• 卸载第三方的net和tls包，执行命令：

  npm uninstall net tls
  

• （可选）清理npm缓存并重新安装依赖，确保依赖状态正确：

  npm cache clean --force
  npm install
  

• 你的连接代码本身无问题，卸载多余依赖后，mysql2会自动调用Node.js内置的net模块，重新运行即可正常创建连接。

补充说明 #

Node.js的核心模块（如net、tls、fs等）无需通过npm安装，直接require即可使用。安装第三方同名包会覆盖核心模块的引用，引发这类兼容性问题。

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