部署应用至Google App Engine时遭遇HTTP 500错误求助

核心问题 #

你的应用启动失败导致GAE无法创建实例，最终返回500错误，主要有三个原因：

1. 代码未定义hostname变量 #

服务器启动的日志输出语句中使用了${hostname}但未提前定义该变量，启动时会抛出ReferenceError: hostname is not defined，直接导致服务崩溃。

2. package.json缺少正确启动脚本 #

GAE部署Node.js应用时默认执行npm start启动服务，但你的package.json里只有test脚本，没有start脚本，GAE无法正确触发应用启动。

3. Node.js 10 runtime已废弃 #

Google App Engine的nodejs10 runtime早已停止官方支持，不再维护该版本运行环境，可能导致部署后无法正常运行。

修复步骤 #

步骤1：修复代码变量错误 #

修改app.js，补充hostname定义或简化日志输出：

const http = require('http');

const port = 8080;
const hostname = '0.0.0.0'; // 新增变量定义

const server = http.createServer((req, res) => {
  res.statusCode = 200;
  res.setHeader('Content-Type', 'text/plain');
  res.end('Do not have an inflated sense of yourself. You are just food for worms.');
});

server.listen(port, hostname, () => {
  console.log(`Server running at http://${hostname}:${port}/`);
});

或者省略hostname，简化日志：

server.listen(port, () => {
  console.log(`Server running on port ${port}`);
});

步骤2：更新package.json启动脚本 #

在scripts字段中添加start命令：

{
  "name": "app-engine",
  "version": "1.0.0",
  "description": "",
  "main": "app.js",
  "scripts": {
    "start": "node app.js", // 新增GAE默认调用的启动脚本
    "test": "node app.js"
  },
  "engines": {
    "node": "18.x" // 同步升级到官方支持的版本
  },
  "author": "",
  "license": "ISC"
}

步骤3：更新app.yaml的runtime版本 #

将runtime改为当前支持的Node.js版本，比如nodejs18：

runtime: nodejs18

步骤4：重新部署并验证 #

执行部署命令：

gcloud app deploy

部署完成后访问URL验证，若仍有问题，可通过日志排查细节：

gcloud app logs tail -s default

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