使用GCS签名策略上传文件时${filename}参数报错求助

问题情况 #

尝试通过Google Cloud Storage（GCS）签名策略实现用户自定义文件名的文件上传，按照官方文档使用${filename}作为文件名占位符，但上传时返回InvalidPolicyDocument错误，提示表单内容不符合策略文档的条件，详情显示Failed condition: {"key":"${filename}"}。相同逻辑在Amazon S3的createPresignedPost方法中可正常运行。

错误返回内容 #

<?xml version='1.0' encoding='UTF-8'?>
<Error>
    <Code>InvalidPolicyDocument</Code>
    <Message>The content of the form does not meet the conditions specified in the policy document.</Message>
    <Details>Failed condition: {"key":"${filename}"}</Details>
</Error>

原生成策略代码 #

const { Storage } = require('@google-cloud/storage');
const storage = new Storage();

generateSignedPolicy = () => {
        const bucket = 'some-bucket';
        const file = storage.bucket(bucket).file("someFolder/${filename}");

        const options = {
          expires: Date.now() + (1000 * 300),
          conditions : [
            { bucket : bucket },
          ]
        };

        return new Promise((resolve, reject) => {
            file.generateSignedPostPolicyV4(options)
            .then(([res]) => resolve(res))
            .catch(error => reject(error))
        })
    } 

生成的策略内容 #

{
  "url": "https://storage.googleapis.com/some-bucket/",
  "fields": {
    "key": "someFolder/${filename}",
    "x-goog-date": "20221015T212358Z",
    "x-goog-credential": "credential",
    "x-goog-algorithm": "GOOG4-RSA-SHA256",
    "policy": "policy",
    "x-goog-signature": "signature"
  }
}

问题原因 #

GCS与S3对动态文件名的处理逻辑不同：

• S3的createPresignedPost会自动识别${filename}作为动态占位符，并生成对应的策略条件。
• GCS中直接将${filename}写入file()路径时，生成的策略会把${filename}当作固定字符串，而用户上传时提交的实际文件名与该固定字符串不匹配，导致条件验证失败。需要在策略的conditions中显式定义允许的key格式。

解决方案 #

修改策略生成代码，在conditions中添加对key的动态规则，并调整file路径的定义：

修正后的代码 #

const { Storage } = require('@google-cloud/storage');
const storage = new Storage();

generateSignedPolicy = () => {
    const bucket = 'some-bucket';
    // 仅指定文件夹路径，不包含文件名占位符
    const file = storage.bucket(bucket).file("someFolder/");

    const options = {
        expires: Date.now() + (1000 * 300),
        conditions: [
            { bucket: bucket },
            // 添加条件：允许key以"someFolder/"开头，用户可自定义后续文件名
            ["starts-with", "$key", "someFolder/"]
        ]
    };

    return new Promise((resolve, reject) => {
        file.generateSignedPostPolicyV4(options)
            .then(([res]) => {
                // 将key字段设置为带占位符的格式，方便前端替换为实际文件名
                res.fields.key = "someFolder/${filename}";
                resolve(res);
            })
            .catch(error => reject(error));
    });
}

关键说明 #

1. 条件定义：通过["starts-with", "$key", "someFolder/"]允许用户提交以someFolder/开头的任意key值，确保自定义文件名符合路径规则。
2. 占位符处理：手动将返回的key字段设置为someFolder/${filename}，前端在提交表单时需要将${filename}替换为用户实际选择的文件名（如someFolder/my-photo.jpg）。

如果需要严格限制key格式为someFolder/自定义文件名，也可以使用以下条件：

conditions: [
    { bucket: bucket },
    ["eq", "$key", "someFolder/${filename}"]
]

这种情况下，前端必须将key字段的值替换为完整的路径+文件名，不能保留${filename}占位符。

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