运行discord-rpc代码报Could not connect连接错误如何解决

数据老陈

2026-9-3

Discord RPC 报「Could not connect」错误排查与修复

这个错误是RPC客户端无法通过IPC通道连接到本地Discord进程导致的，按以下优先级排查即可：

优先确认运行环境
discord-rpc的IPC通信机制要求代码必须和Discord桌面客户端运行在同一台物理设备上。从你的报错路径/home/runner/Toshiro/判断，你当前是在Replit这类云端在线IDE中运行代码，云端环境没有权限访问你本地电脑上运行的Discord程序，必然会抛出连接错误。这类场景必须把代码放到本地电脑运行，不要用在线IDE、云服务器跑本地RPC状态脚本。
如果是在本地运行报这个错，先确认Discord客户端已经完成启动、正常登录账号，不要在客户端刚打开还在加载的状态下跑脚本。
检查Discord客户端权限配置
打开Discord「用户设置-活动隐私」页面，确认将当前活动作为状态消息显示开关处于开启状态，关闭这个开关后Discord会拒绝所有RPC连接请求。
修复代码配置问题
你当前的代码有两个可优化点，其中一个会间接导致连接异常：
1. 强制指定transport: "ipc"在Windows部分版本、Linux权限不足的场景下会找不到IPC通道，可以删除这个配置让库自动选择可用传输方式，或者临时改成transport: "websocket"测试连通性
2. startTimestamp: Date.now()写在setActivity函数内部，会导致每15秒刷新状态时重置活动开始时间，应该把时间戳提到函数外只初始化一次
本地环境特殊场景排查
- Linux本地运行时，先检查当前用户是否有Discord IPC套接字的读写权限，套接字默认路径为/run/user/[你的用户UID]/discord-ipc-0，权限不足时给当前用户加对应读写权限即可
- Windows/macOS如果同时安装了稳定版、测试版（PTB）、开发版三个Discord客户端，先在任务管理器里结束所有Discord相关进程，只启动一个客户端再运行脚本，多开客户端会抢占IPC端口导致连接失败
- 确认你在Discord开发者后台为对应clientId上传了books、verified两个图片资源，否则活动状态的图标无法正常加载（该问题不会触发连接错误，属于配置补全项）

修正后的可运行代码如下：

const clientId = "960430276532645888"
const DiscordRPC = require("discord-rpc");
// 移除强制transport配置，自动适配可用连接方式
const RPC = new DiscordRPC.Client();

DiscordRPC.register(clientId);
// 活动开始时间全局只初始化一次
const startTimestamp = Date.now();

async function setActivity() {
  if (!RPC) return;
  RPC.setActivity({
    details: `Reading`,
    state: `all subjects`,
    startTimestamp,
    largeImageKey: `books`,
    largeImageText: `books`,
    smallImageKey: `verified`,
    smallImageText: `verified`,
    instance: false,
    buttons: [
      {
        label: `Join Me :)`,
        url: `https://www.sanfransentinel.com/combine-study.html`,
      },
    ]
  });
};

RPC.on('ready', async () => {
  setActivity();
  setInterval(setActivity, 15 * 1000);
})

RPC.login({ clientId }).catch(err => console.error(err));

注意：不要尝试在无Discord桌面客户端的纯服务器环境运行该脚本，Discord RPC不支持纯服务端部署，必须依托本地运行的桌面客户端才能生效。

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