Cloud Workflows Storage Connector无法访问GCS子目录对象如何解决？

针对你遇到的问题，以下是几个排查和解决方向：

1. 确认对象名称的绝对准确性 #

GCS对象名称区分大小写且严格匹配，先通过gsutil命令验证对象是否真的存在：

gsutil ls gs://bucket-name/folder/test_file.txt

如果命令返回对象路径，再用gsutil stat查看对象的准确名称：

gsutil stat gs://bucket-name/folder/test_file.txt

重点检查名称中的大小写、斜杠数量、是否包含空格或特殊字符（比如全角斜杠），确保Workflows代码里的object值和实际对象名称完全一致。

2. 手动编码对象名称 #

虽然Google Cloud Workflows的GCS连接器通常会自动处理URL编码，但部分特殊场景下手动编码可以解决路径解析问题。修改代码使用urlencode函数处理对象名称：

# target object is gs://bucket-name/folder/test_file.txt
main:
  steps:
    - file_init:
        assign:
          - bucket: bucket-name
          - object: folder/test_file.txt
          - encoded_object: ${urlencode(object)}
    - fetch_file_details:
        call: googleapis.storage.v1.objects.get
        args:
            bucket: ${bucket}
            object: ${encoded_object}
        result: getResult
    - out:
        return: ${getResult}

3. 排除权限干扰（虽然404不是典型权限错误） #

确认Workflows使用的服务账号拥有storage.objects.get权限。你可以通过IAM控制台为服务账号添加Storage Object Viewer角色，再重新测试流程。

4. 检查是否存在占位符对象 #

如果之前手动创建过名为folder/的空对象（目录占位符），不会直接导致子对象404，但可以通过gsutil rm gs://bucket-name/folder/删除该占位符后重试，排除潜在的路径解析冲突。

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