Node.js应用在Heroku构建失败：gyp依赖Python版本不兼容问题

你遇到的核心问题是node-gyp构建node-expat依赖时需要Python 2.x版本，但新Heroku应用的默认环境版本不匹配，且之前的Buildpack配置没有按预期生效。旧应用能正常运行是因为当时的Heroku环境或Buildpack默认提供了兼容的Python版本，新应用需要明确配置来对齐这个环境。

下面是一步步的解决方案：

1. 调整Buildpack执行顺序（关键步骤） #

Heroku会按Buildpack的顺序执行构建流程，你需要让Python Buildpack先加载，这样Node.js构建时能优先找到指定的Python 2.7版本。执行以下命令：

# 清除现有Buildpack配置
heroku buildpacks:clear
# 添加Python Buildpack
heroku buildpacks:add heroku/python
# 添加Node.js Buildpack（放在Python之后）
heroku buildpacks:add heroku/nodejs

2. 确认runtime.txt配置准确性 #

确保项目根目录的runtime.txt内容无拼写错误：

python-2.7.14

3. 强制node-gyp使用Python 2.7 #

在package.json中添加gyp配置段，直接指定node-gyp要使用的Python版本，避免它去环境中查找默认版本：

{
  "engines": {
    "node": "10.17.0",
    "npm": "6.11.3"
  },
  "gyp": {
    "python": "python2.7"
  }
}

4. 清除Heroku构建缓存 #

Heroku可能缓存了旧的依赖或环境配置，导致新设置不生效，执行命令清除缓存：

heroku builds:cache:purge

5. 重新推送代码 #

完成以上配置后，重新推送代码到Heroku：

git push heroku main

额外验证：对齐旧应用的Buildpack配置 #

如果问题仍存在，可以查看旧应用的Buildpack设置，确保新应用完全对齐：

heroku buildpacks --app your-old-app-name

将旧应用的Buildpack顺序和配置完全复制到新应用即可。

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