Ubuntu环境下Discord.js机器人无法连接网关的问题求助

DevOps 小满

2026-5-11

解决Discord机器人在Ubuntu VPS的PM2中反复出现INVALID SESSION报错的问题

我之前迁移Discord机器人到VPS时也碰到过几乎一模一样的问题，结合Discord网关的工作机制和Ubuntu环境的常见坑，给你几个针对性的排查和解决步骤：

确认机器人令牌与配置正确性
先排查最基础的问题：检查VPS上机器人配置文件（比如.env或者硬编码的令牌）里的DISCORD_TOKEN是否和Discord开发者后台完全一致，有没有多余的空格、换行符或者拼写错误。如果之前在开发者后台重置过令牌，一定要同步更新VPS上的配置——我当时就是因为重置令牌后忘了改VPS的.env文件，折腾了好久。
检查VPS的网络与防火墙限制
Discord网关依赖WebSocket连接（默认走443端口），很多VPS服务商的安全组或者Ubuntu本地的ufw防火墙可能会限制出站的443连接。
1. 先测试连通性：在VPS终端执行 telnet gateway.discord.gg 443，如果能连通会显示类似Connected to gateway.discord.gg的信息；如果连接失败，说明网络有问题。
2. 临时关闭ufw测试：执行 sudo ufw disable，然后重启PM2里的机器人，如果不再报错，就需要在ufw里添加允许出站443的规则：sudo ufw allow out 443/tcp，再重新启用ufw：sudo ufw enable。
3. 同时检查VPS服务商的安全组配置，确保出站方向的443端口是放行的。
修复PM2的环境变量加载问题
Windows和Linux的环境变量文件格式有差异，比如Windows下的.env文件用的是DOS换行符，到Ubuntu里可能会导致变量解析错误。
1. 转换.env文件的换行符：执行 dos2unix .env（如果没有dos2unix，先安装sudo apt install dos2unix）。
2. 或者直接在PM2的启动配置里明确指定环境变量，比如创建ecosystem.config.js：
```
module.exports = {
  apps: [{
    name: "Bot",
    script: "./bot.js",
    env: {
      DISCORD_TOKEN: "你的机器人令牌",
      NODE_ENV: "production"
    }
  }]
}
```
  然后用pm2 start ecosystem.config.js启动机器人。
重新安装依赖与检查Node版本
有些Node.js的原生依赖（比如ws，Discord网关依赖的WebSocket库）在Windows和Linux上的编译版本不一样，可能导致连接失败。
1. 先检查Node版本：node -v，尽量和Windows上运行的Node版本保持一致（比如都是18.x或者20.x），版本差异过大可能引发兼容性问题。
2. 重新安装依赖：删除旧的依赖文件，执行 rm -rf node_modules package-lock.json && npm install，确保所有依赖都是针对Ubuntu环境重新编译的。
调整机器人的网关连接配置
报错里显示Resumable: false，说明会话无法恢复，可能是网关连接的重试逻辑或者分片配置有问题：
1. 如果你的机器人用了分片（Shard），检查分片数量是否符合Discord的要求（可以在开发者后台查看机器人的推荐分片数），或者暂时关闭分片测试（如果机器人规模不大，单分片足够的话）。
2. 在机器人的客户端配置里明确开启自动重连，以Discord.js为例：
```
const { Client, GatewayIntentBits } = require('discord.js');
const client = new Client({
  intents: [GatewayIntentBits.Guilds, ...],
  reconnect: true, // 开启自动重连
  retryLimit: 5 // 设置重试次数
});
```

按照这些步骤逐一排查，应该能解决这个循环报错的问题。

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