GCloud Node.js已部署应用下载及uploads文件夹404问题排查求助

我来帮你搞定这两个问题——先解决图片404的核心bug，再教你怎么把线上的uploads文件夹拉到本地查看。

一、先搞定线上图片404的问题 #

本地正常、线上404，大概率是两个原因：路径配置问题或者GCloud App Engine的存储特性限制，咱们一步步排查：

1. 先修正静态资源的绝对路径配置 #

你现在用的是相对路径express.static('uploads')，在本地环境没问题，但GCloud部署时，Node.js的工作目录可能和你本地不一致，导致找不到uploads文件夹。改成绝对路径就稳了：

const path = require('path');
// 用__dirname拼接出uploads的绝对路径
app.use('/static', express.static(path.join(__dirname, 'uploads')));

2. 核心问题：App Engine的本地存储是临时的！ #

这是很多人踩过的坑：GCloud App Engine（标准环境）的文件系统是临时且非持久化的，实例重启后，所有本地存储的文件（包括uploads里的图片）都会被清空。而且多实例部署时，不同实例的uploads文件夹是独立的，用户上传到A实例的图片，B实例根本访问不到，自然返回404。

解决方案：改用Cloud Storage存储上传文件

把用户上传的图片直接存到GCloud的Cloud Storage里，这才是持久化存储的正确姿势。这里给你一个用multer-google-storage的示例：

const path = require('path');
const { Storage } = require('@google-cloud/storage');
const Multer = require('multer');
const MulterGoogleCloudStorage = require('multer-google-storage');

// 初始化Cloud Storage客户端
const storage = new Storage({ projectId: '你的GCloud项目ID' });
// 配置multer的存储引擎为Cloud Storage
const multerStorage = new MulterGoogleCloudStorage({
  storage: storage,
  bucket: '你的Cloud Storage存储桶名称', // 提前在GCloud控制台创建好存储桶
  filename: (req, file, cb) => {
    // 保持你原来的文件名生成逻辑，避免重名
    const uniqueSuffix = Date.now() + '-' + Math.round(Math.random() * 1E9);
    cb(null, `${file.fieldname}-${uniqueSuffix}${path.extname(file.originalname)}`);
  }
});

const upload = Multer({ storage: multerStorage });

之后访问图片时，你可以直接用Cloud Storage的公共URL（需要把存储桶设置为公开可读），或者通过你的Node.js服务代理返回图片。

3. 检查app.yaml的静态资源配置 #

如果你的app.yaml里也配置了/static路径的静态资源，会和express的配置冲突，导致请求被App Engine直接拦截而没到你的Node.js服务。如果用express处理静态资源，把app.yaml里相关的静态资源配置删掉就行。

二、下载线上的uploads文件夹 #

因为App Engine的本地存储是临时的，只有当前运行的实例还没重启时，uploads里的文件才存在。下载步骤如下：

1. 先列出你的App Engine服务和版本：

gcloud app versions list

找到你正在运行的版本号和实例ID。

2. SSH连接到目标实例：

gcloud app instances ssh [你的实例ID] --service=[服务名称，默认是default] --version=[版本号]

3. 在实例里找到uploads文件夹并打包：
   假设你的uploads在项目根目录，执行：

cd /workspace # 这是App Engine标准环境Node.js的默认工作目录，根据你的项目调整
tar -czf uploads.tar.gz uploads/

4. 把打包好的文件下载到本地：

gcloud app instances scp [你的实例ID]:~/uploads.tar.gz ./ --service=default --version=[版本号]

5. 最后在本地解压：

tar -xzf uploads.tar.gz

⚠️ 注意：如果实例已经重启过，uploads里的文件已经被清空了，这时候就没法下载到了——这也是为什么一定要用Cloud Storage做持久化存储的原因！

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