部署到Google App Engine的Hardhat项目出现CORS及500错误求助

一、修复CORS错误 #

1. 正确配置Express CORS中间件
   先安装cors依赖：

   npm install cors
   

   在Express服务代码中添加配置，生产环境替换为你的前端域名，测试阶段可临时用*：

   const cors = require('cors');
   const corsOptions = {
     origin: 'https://your-frontend-domain.com',
     methods: ['POST', 'OPTIONS'],
     allowedHeaders: ['Content-Type']
   };
   app.use(cors(corsOptions));
   // 手动处理OPTIONS预请求（避免部分环境下中间件自动处理失效）
   app.options('*', cors(corsOptions));
   

2. 确认前端请求的Origin未被GAE负载均衡或浏览器安全策略拦截，确保请求头中的Origin与配置的允许值匹配。

二、排查并修复500内部错误 #

1. 处理Hardhat文件系统权限问题 #

GAE标准环境大部分目录为只读，Hardhat默认的缓存、编译目录无法写入，会导致部署失败：

• 方案1：提前本地编译合约
  本地执行npx hardhat compile，将生成的artifacts和cache文件夹提交到代码仓库，部署脚本中跳过编译步骤：

  await hre.run('deploy', { noCompile: true });
  

• 方案2：配置Hardhat使用可写的/tmp目录
  修改hardhat.config.js，指定临时目录存储缓存和编译产物：

  module.exports = {
    paths: {
      cache: '/tmp/hardhat-cache',
      artifacts: '/tmp/hardhat-artifacts'
    },
    // 其他Hardhat配置...
  };
  

2. 确保依赖正确安装 #

检查package.json，将Hardhat相关依赖从devDependencies移至dependencies——GAE生产环境只会安装dependencies中的包：

{
  "dependencies": {
    "express": "^4.18.2",
    "hardhat": "^2.19.0",
    "@nomicfoundation/hardhat-toolbox": "^3.0.0",
    "cors": "^2.8.5"
    // 其他必要依赖...
  }
}

3. 配置环境变量 #

GAE不会加载本地.env文件，需将部署合约所需的敏感信息（如RPC URL、私钥）通过Google Cloud控制台配置：

• 进入GAE服务的设置 > 环境变量，添加RPC_URL、PRIVATE_KEY等变量
• 私钥建议用Google Secret Manager存储，避免明文暴露

4. 查看GAE日志定位具体错误 #

登录Google Cloud控制台的日志资源管理器，筛选GAE服务的日志，查看500错误的详细栈信息（比如模块缺失、私钥无效、RPC连接失败等），这是定位问题最直接的方式。

三、验证部署 #

先通过curl测试API，排除前端CORS干扰：

curl -X POST https://your-gae-service-url/deploy -H "Content-Type: application/json" -d '{}'

返回正常后再测试前端请求。

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