Google Cloud Storage API报错无法打开文件 确认文件存在如何排查

返回的code:5对应google.rpc.Code.NOT_FOUND错误，除文件不存在外，还有以下常见原因和排查方案：

可能的原因 #

• 服务账号权限不足：调用对应GCP API的服务账号没有目标GCS对象的读取权限，服务侧无法拉取文件就会返回打开失败错误，和文件实际是否存在无关
• 路径拼写不匹配：GCS路径是大小写敏感的，路径存在大小写错误、多余空格、特殊字符未正确转义时，都会被识别为路径不存在
• 跨区域访问限制：你使用的GCP服务（如视觉产品搜索）部署区域和GCS存储桶区域不一致，部分服务默认禁止跨区域拉取资源
• CSV索引文件格式错误：你上传的CSV文件内对应的路径存在多余前缀、后缀或不可见字符，和实际GCS路径不匹配
• 存储桶访问规则限制：存储桶开启了公共访问阻止、VPC端点限制、统一存储桶级访问后未配置对应权限，导致服务无法访问资源

排查步骤 #

1. 验证路径有效性：本地执行gcloud命令gsutil cat gs://furniture-vsearch/dtbo160x90x75w5m1-hero-618173ee-high.jpeg，如果能正常返回说明路径本身没有问题，返回403说明权限不足，返回404说明路径拼写错误
2. 核对服务账号权限：找到你调用API使用的服务账号邮箱，为其授予目标存储桶的Storage Object Viewer角色，至少要包含storage.objects.get权限，权限配置后等待2分钟生效再重试
3. 校验CSV文件内容：打开你上传的索引CSV文件，检查第一行对应的GCS路径和报错路径完全一致，没有多余空格、换行符等不可见字符
4. 确认区域一致性：核对你使用的GCP服务的部署区域，和GCS存储桶的所属区域，两者不一致的话建议将文件迁移到和服务同区域的存储桶再测试
5. 检查存储桶访问限制：查看存储桶是否开启了公共访问阻止、VPC访问限制，如果有相关限制，需要将调用服务的服务账号添加到白名单，或者开放对应访问权限

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