npm包clipboardy在Heroku部署Discord Bot时无法运行，求解决方案

报错根因 #

clipboardy依赖操作系统原生剪贴板工具运行，你本地Windows 10环境自带对应的剪贴板接口，所以运行正常。而Heroku的Linux运行环境默认没有安装xsel/xclip这类剪贴板工具，因此触发报错。 #

可选解决方法 #

方法1：给Heroku环境安装xsel依赖 #

你可以通过Heroku官方的apt buildpack安装系统级依赖，操作步骤如下：

• 在项目根目录新建无后缀的Aptfile文件
• 往Aptfile内写入一行内容：xsel
• 在本地终端执行Heroku CLI命令添加buildpack：
  heroku buildpacks:add --index 1 heroku-community/apt
• 正常提交代码部署即可，Heroku构建阶段会自动安装xsel，解决依赖缺失问题

方法2：替换为无系统依赖的剪贴板包 #

如果不想修改运行环境配置，可以直接替换clipboardy为兼容API的纯JS实现包：

• 可选替代包为clipboardy-lite，无任何系统依赖，API与clipboardy完全对齐，仅需要替换依赖包即可，原有业务代码不需要修改

方法3：移除或mock clipboardy（适合不需要实际使用剪贴板的场景） #

如果你的Discord Bot功能本身不需要调用系统剪贴板，属于误引入依赖：

• 直接卸载clipboardy即可从根源解决问题
• 如果是第三方依赖引入了clipboardy，可在代码入口处添加mock逻辑跳过实际调用：

if (process.env.NODE_ENV === 'production') {
  const module = require('module');
  const originalRequire = module.prototype.require;
  module.prototype.require = function(path) {
    if (path === 'clipboardy') {
      return {
        read: () => Promise.resolve(''),
        write: () => Promise.resolve()
      };
    }
    return originalRequire.apply(this, arguments);
  };
}

内容的提问来源于stack exchange，提问作者Ajharul Haque Choudhury