Electron+Webpack+WebTorrent集成异常：端口问题与TCPPool缺失解决方案咨询

你遇到的核心问题是Webpack打包过程中把WebTorrent依赖的TCPPool类误做Tree-shaking移除了，导致它无法自动分配端口完成种子下载。结合你提到的WebTorrent Desktop正常运行的情况，下面是几个针对性的解决办法：

1. 阻止Webpack对WebTorrent进行Tree-shaking #

Webpack的Tree-shaking机制会移除它认为“未被使用”的代码，但WebTorrent内部是动态调用TCPPool的，Webpack无法识别这种隐性依赖，所以会误删。你可以在Webpack配置里关闭相关优化：

// webpack.config.js
module.exports = {
  optimization: {
    usedExports: false, // 关闭基于导出的Tree-shaking
    sideEffects: true   // 确保WebTorrent的副作用代码被完整保留
  }
}

也可以直接给WebTorrent添加noParse规则，让Webpack不对它进行解析打包，保留原始模块结构：

module.exports = {
  module: {
    noParse: /webtorrent/
  }
}

2. 显式引入TCPPool强制Webpack打包它 #

最简单的办法是在你的代码里手动引入TCPPool类，哪怕你不会直接使用它，这样Webpack就会把它包含在打包产物里：

// 在初始化WebTorrent的代码顶部添加
import 'webtorrent/lib/tcp-pool'
// 或者CommonJS语法
require('webtorrent/lib/tcp-pool')

3. 确保Electron启用了Node.js集成 #

WebTorrent依赖Node.js的net、dgram等网络模块，在Electron渲染进程里需要正确配置WebPreferences才能访问这些模块：

// main.js 中创建BrowserWindow的配置
const mainWindow = new BrowserWindow({
  webPreferences: {
    nodeIntegration: true, // 启用Node.js集成
    contextIsolation: false, // 关闭上下文隔离（Electron 12+默认开启，需要关闭才能直接访问Node模块）
    // 若使用Electron 16+，更推荐用preload脚本暴露必要API，这里为快速验证可先关闭隔离
  }
})

4. 设置正确的Webpack Target #

因为是Electron应用，Webpack的target需要设置为electron-renderer（渲染进程）或electron-main（主进程），而不是默认的web，这样Webpack会适配Electron的Node.js环境：

// webpack.config.js
module.exports = {
  target: 'electron-renderer',
  // 其他配置项
}

5. 尝试使用WebTorrent的UMD预打包版本 #

如果上面的配置都不生效，可以绕过Webpack打包，直接使用WebTorrent的UMD版本：

<!-- 在渲染进程的HTML文件中引入 -->
<script src="https://cdn.jsdelivr.net/npm/webtorrent@latest/webtorrent.min.js"></script>

然后在你的代码里直接使用全局的WebTorrent对象，这样就不会受Webpack打包的影响了。

按照上面的步骤逐一尝试，应该能解决TCPPool未定义的问题，让WebTorrent在Electron+Webpack环境下正常工作。

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