GCP存储桶托管静态网站：索引页与错误页无法正常生效

问题背景 #

按照GCP静态网站托管文档，使用存储桶部署React静态SPA，需求是访问/my_directory时自动返回对应目录下的index.html，配置和文档中“三对象存储桶”的要求一致，但出现多个异常现象。

配置与文件结构 #

• 存储桶配置：
  
• 文件结构：
  
  test_2023_11_03_c目录下存在index.html文件。

异常现象 #

• 访问桶根路径https://storage.googleapis.com/my-bucket-name，未返回主index.html，而是显示桶内所有文件列表；
• 访问不存在的路径https://storage.googleapis.com/my-bucket-name/something-that-doesnt_exist，未返回自定义错误页my_error.html，而是返回XML格式错误：

<?xml version='1.0' encoding='UTF-8'?><Error><Code>NoSuchKey</Code><Message>The specified key does not exist.</Message><Details>No such object: my-bucket-name/something-that-doesnt_exist</Details></Error>

• 访问https://storage.googleapis.com/my-bucket-name/test_2023_11_03_c，未返回该目录下的index.html，同样返回上述XML错误。

问题原因及解决方法 #

1. 未启用静态网站托管模式 #

从配置截图判断，你可能仅设置了主页面后缀和错误页面，但未开启存储桶的静态网站托管功能。GCP存储桶默认是对象存储模式，只有明确启用静态网站托管后，才会触发路径重写、默认页面返回等逻辑。

解决：

• 进入存储桶的「网站」设置页面，确认已勾选「启用静态网站托管」选项；
• 确保主页面后缀设为index.html，错误页面设为my_error.html。

2. 使用了对象存储端点而非静态网站端点 #

你当前访问的https://storage.googleapis.com/my-bucket-name是对象存储API端点，这类端点不会触发静态网站的路径规则，只会返回原始对象或文件列表。静态网站托管需要使用专属端点：

• 格式一：https://[bucket-name].storage.googleapis.com
• 格式二：若绑定了Firebase，可使用https://[bucket-name].web.app或https://[bucket-name].firebaseapp.com

解决：

• 切换为静态网站专属端点访问；
• 若已配置自定义域名，直接使用自定义域名访问。

3. 目录对象键名格式错误 #

GCP存储桶中没有实际的“文件夹”，目录通过对象键名的前缀模拟。需确保test_2023_11_03_c下的index.html的对象键名是test_2023_11_03_c/index.html，而非单独的test_2023_11_03_c（后者是独立对象，不属于目录下的文件）。

验证：

• 在存储桶对象列表中查看该文件的完整键名，确认格式正确。

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