Heroku推送部署时valid-url无法访问错误排查

• 经Heroku CLI推送、GitHub集成两种方式向Heroku平台部署代码时，固定触发报错：valid-url not accessible from @heroku-cli/plugin-buildpacks
• 已尝试公开渠道可检索到的所有相关解决方案，问题仍未解决
• 项目本地运行无异常，代码推送GitHub流程正常，仅Heroku部署环节报错，初步判断故障与buildpack机制相关
• 旧设备上曾多次成功部署该项目及其他Heroku应用，更换新设备后首次部署即出现该问题，怀疑本地环境配置差异为故障诱因

项目package.json配置 #

{
  "name": "backend",
  "version": "1.0.0",
  "description": "",
  "main": "app.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "start": "node server.js",
    "dev": "nodemon server.js",
    "prodd": "NODE_ENV=production node server.js"
  },
  "engines": {
    "node": "14.x"
  },
  "author": "",
  "license": "ISC",
  "dependencies": {
    "@heroku/buildpack-registry": "^1.0.1",
    "aws-sdk": "^2.874.0",
    "axios": "^0.21.1",
    "bcrypt": "^5.0.1",
    "bcryptjs": "^2.4.3",
    "cookie-parser": "^1.4.5",
    "cors": "^2.8.5",
    "cron": "^1.8.2",
    "crypto": "^1.0.1",
    "crypto-js": "^4.0.0",
    "dotenv": "^8.2.0",
    "express": "^4.17.1",
    "express-mongo-sanitize": "^2.0.2",
    "express-rate-limit": "^5.2.6",
    "google-auth-library": "^7.0.4",
    "helmet": "^4.4.1",
    "heroku": "^7.60.2",
    "html-to-text": "^7.0.0",
    "http-proxy-middleware": "^1.2.0",
    "jsonwebtoken": "^8.5.1",
    "mjml": "^4.9.0",
    "moment": "^2.29.1",
    "moment-timezone": "^0.5.33",
    "mongoose": "^5.12.1",
    "multer": "^1.4.2",
    "multer-s3": "^2.9.0",
    "nodemailer": "^6.5.0",
    "nodemon": "^2.0.7",
    "pug": "^3.0.2",
    "redis": "^3.1.0",
    "request": "^2.88.2",
    "select": "^1.1.2",
    "sharp": "^0.28.3",
    "twilio": "^3.59.0",
    "util": "^0.12.3",
    "validator": "^13.5.2",
    "xss-clean": "^0.1.1"
  }
}

全局npm包安装截图 #

问题核心出在依赖配置错误：你把Heroku CLI本身作为业务依赖装进了项目，"heroku": "^7.60.2"和"@heroku/buildpack-registry": "^1.0.1"都是Heroku命令行工具的内部依赖，不该出现在业务项目的dependencies列表里，部署时这两个包会和Heroku构建环境预装的buildpack插件产生依赖冲突，直接导致valid-url依赖寻址失败。
按以下步骤操作即可修复：

1. 移除项目内错误引入的Heroku相关依赖

npm uninstall heroku @heroku/buildpack-registry

2. 重装本地Heroku CLI，不要用npm全局安装Heroku CLI——npm分发的版本经常存在依赖链路损坏的问题，官方也不推荐这种安装方式，直接用对应系统的官方安装包重装最新版即可，装完执行heroku --version确认能正常输出版本号。
3. 清理缓存避免旧依赖残留

# 清理本地依赖缓存重装
rm -rf node_modules package-lock.json
npm install

# 清理Heroku端的构建缓存
heroku plugins:install heroku-builds
heroku builds:cache:purge -a 替换成你自己的Heroku应用名

4. 检查项目根目录，如果有.heroku本地配置文件夹直接删除，这类本地CLI运行生成的文件不要提交到代码仓库。
5. 提交变更后的代码，重新触发部署即可。

额外提两个配置隐患：crypto、util都是Node.js原生内置模块，不需要单独在dependencies里引入，多余安装反而可能引发版本冲突；nodemon是本地开发用的工具，应该移到devDependencies下，不要打进生产依赖。

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