Node.js Hyperswarm P2P拍卖脚本终端间无法连接求助

• 确认Announce主题完全一致
  Hyperswarm对主题的匹配是字节级别的，哪怕细微的编码或格式差异都会导致无法发现节点。检查两个节点使用的announce主题是否完全相同，比如统一用Buffer格式定义：

  const AUCTION_TOPIC = Buffer.from('p2p-auction-system-topic', 'utf8')
  

  避免一端用字符串、另一端用Buffer，或者主题字符串存在空格/大小写差异。

• 细化Hyperswarm的Bootstrap配置检查
  即便Bootstrap日志显示正常，也要确认配置的节点是当前网络可访问的。可以替换为公开稳定的Hyperswarm Bootstrap节点列表，同时确保实例没有错误限制客户端/服务端模式：

  const swarm = hyperswarm({
    bootstrap: [
      'bootstrap.hyperdht.org:49737',
      'bootstrap2.hyperdht.org:49737'
    ],
    // 默认同时开启客户端和服务端模式，不要手动设为false
    client: true,
    server: true
  })
  

  也可以尝试在本地启动一个私有Bootstrap节点（用hyperswarm-bootstrap包），避免公共节点的网络波动影响。

• 排查本地网络限制
  如果两个终端在同一台机器，临时关闭防火墙或杀毒软件，部分安全工具会拦截P2P端口。也可以手动指定Hyperswarm使用的端口，避免端口占用：

  const swarm = hyperswarm({ port: 36215 }) // 指定未被占用的端口
  

  若在不同机器，确保处于同一局域网；如果是跨公网，检查网络是否为严格对称NAT（这类环境下Hyperswarm的NAT穿透可能失败），可以尝试给其中一个节点手动指定公网IP。

• 验证Hypercore/Hyperbee的密钥共享
  拍卖数据同步依赖Hypercore的密钥一致性，必须确保所有节点使用同一个Hypercore密钥。如果每个节点自行生成密钥，数据必然无法同步：

  // 节点1创建Hypercore后导出密钥
  const core = hypercore('./db1', { valueEncoding: 'json' })
  await core.ready()
  console.log('Hypercore密钥:', core.key.toString('hex'))
  
  // 节点2导入该密钥初始化Hypercore
  const coreKey = Buffer.from('节点1输出的十六进制密钥', 'hex')
  const core = hypercore('./db2', coreKey, { valueEncoding: 'json' })
  

  Hyperbee基于Hypercore运行，只要Hypercore密钥一致，数据就能自动同步。

• 添加精细化调试日志
  给Hyperswarm实例监听更多事件，明确问题出在节点发现阶段还是连接阶段：

  swarm.on('discovery', (peer) => {
    console.log('发现对等节点:', peer.publicKey.toString('hex'))
  })
  swarm.on('connection', (conn, info) => {
    console.log('已建立连接:', info.publicKey.toString('hex'))
    conn.on('close', () => console.log('连接断开'))
  })
  swarm.on('announce', () => console.log('已广播主题到网络'))
  swarm.on('error', (err) => console.error('Swarm错误:', err))
  

  通过这些日志可以快速定位是没有广播主题、没有发现节点，还是发现后连接失败。

• 检查依赖版本兼容性
  确认hyperswarm-rpc、hypercore、hyperbee的版本兼容，不同大版本的API差异可能导致节点间无法通信。尽量使用最新稳定版，或确保所有依赖版本匹配。

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