GCP App Engine部署后无法上传文件至Cloud Storage（Node/Express）

一、先解决日志缺失问题（排查核心） #

• 检查app.yaml配置：确认运行时为nodejs，避免写错运行时类型。App Engine默认会收集后端的stdout和stderr输出，后端代码必须用console.log/console.error输出日志，不要使用自定义日志文件路径，否则Cloud Logging（原Stackdriver）无法捕获日志。
• 核对Cloud Logging视图：进入Cloud Console的Logging页面，选择对应的App Engine服务和版本，设置过滤条件为resource.type="gae_app" + service="你的服务名"，同时检查是否误设了日志级别过滤（比如仅查看Error级别，漏掉Info级别的日志）。
• 打包配置检查：如果使用Webpack等工具打包后端代码，生产模式下不要移除console语句，否则部署后日志会直接丢失。

二、文件上传返回200但无文件的排查 #

• 检查App Engine默认服务账号权限：部署后应用使用的是[项目ID]@appspot.gserviceaccount.com默认服务账号，需为该账号添加Cloud Storage的storage.objects.create权限，至少分配Storage Object Creator角色。本地使用的是自定义服务账号密钥，权限足够，但默认账号可能未配置对应权限。
• 后端上传逻辑验证：
  • 若使用multer处理文件，需确保临时目录设置为/tmp（App Engine唯一可写的临时目录），不要使用本地路径，否则部署后无法存储临时文件，会直接跳过上传流程但返回200。
  • 代码中不要硬编码本地服务账号密钥路径！部署后App Engine会自动调用默认凭据，若代码仍读取本地密钥文件，会因找不到文件而静默失败，直接返回200。需调整逻辑：本地环境使用密钥文件，生产环境自动使用默认凭据。
• 跨域与请求检查：若前后端为同一服务，跨域问题可忽略；若为分离部署，需确认后端CORS配置允许前端域名，且正确处理OPTIONS预检请求。有时CORS配置错误会导致请求看似成功，但实际未传输文件。
• 开启Cloud Storage审计日志：进入存储桶设置页面开启审计日志，查看是否有上传请求记录，是否存在访问拒绝日志，可直接定位权限类问题。

三、额外核对项 #

• 环境变量：本地使用的存储桶名称等变量，需在app.yaml的env_variables中配置完整，避免部署后因变量缺失导致文件上传至不存在的存储桶。
• 直接测试后端接口：使用curl调用部署后的接口，例如curl -X POST -F "file=@test.csv" https://[你的服务域名]/upload，查看返回结果和日志，排除前端环节的问题。

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