如何通过API Gateway代理S3实现静态站点的目录列表功能？

遇到这种情况我太熟悉了——S3+API Gateway的组合确实在目录列表这块有不少坑，下面给你两种可行的解决方案，你可以根据自己的需求选择：

方案1：调整配置启用S3原生目录列表 #

S3本身的静态网站托管模式是支持目录列表的，只是你需要调整S3和API Gateway的配置来让它正常工作：

• 首先确认你的S3桶已经开启静态网站托管（不是用S3 REST API访问），并且在桶的权限设置里，允许访问目录列表（可以通过桶策略给API Gateway的执行角色授权，或者开启匿名访问，根据你的安全需求来）。
• 配置API Gateway的代理资源：创建一个/{proxy+}的代理资源，在集成请求的路径映射里，设置为{proxy}，同时要确保API Gateway不会自动去掉请求路径末尾的斜杠——比如当请求{prefix}/时，要完整转发到S3的{prefix}/路径，这样S3才会返回目录列表页面。
• 注意：S3返回的目录列表是HTML格式的，你的前端JS需要解析这个HTML来提取文件信息，比如用正则匹配<a>标签的href属性，或者用DOM解析的方式处理（如果是同域请求的话）。

方案2：用Lambda+API Gateway实现自定义目录列表接口（更灵活可靠） #

如果原生的HTML格式目录列表不好处理，或者你需要过滤文件、返回结构化的JSON数据，那Lambda方案会更适合：

• 写一个简单的Lambda函数，用AWS SDK的listObjectsV2方法查询指定前缀下的S3对象，把结果处理成前端需要的格式（比如返回包含文件名、大小、最后修改时间的JSON数组）。
• 在API Gateway里创建一个专门的资源（比如/{prefix}/list），将其集成到这个Lambda函数，把请求中的prefix作为参数传递给Lambda。
• 前端JS直接请求这个接口，就能拿到结构化的文件列表，不需要解析HTML，逻辑更清晰，也更稳定。

为什么你之前请求{prefix}/会报错？ #

大概率是这两个配置问题导致的：

• API Gateway的代理路径配置有误，没有正确将带斜杠的请求转发到S3对应的路径，导致返回404或500错误。
• 你可能用的是S3的REST API访问模式，而不是静态网站托管模式——S3的REST API在请求文件夹路径时不会返回目录列表，只有静态网站托管模式才会触发这个功能。

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