

# 适用于电子商务和商城应用程序的 CloudFront

电子商务或商城应用程序可通过单个 CloudFront 分配提供三种不同的内容类型：静态资产（产品图片、CSS、JavaScript）、动态页面（产品列表、搜索结果）和 API 响应（购物车、库存、定价）。每种内容类型都需要不同的缓存行为、TTL 和源配置，以便在内容新鲜度与性能之间取得平衡。

有关适用于市场和电子商务分配的安全控制措施，请参阅[商城分配的安全清单](ecommerce-security-checklist.md)。

## 架构概述
<a name="ecommerce-architecture-overview"></a>

商城 CloudFront 分配使用多种缓存行为，以便根据 URL 路径模式将请求路由到正确的源。静态资产从 Amazon Simple Storage Service（Amazon S3）提供，而动态内容和 API 请求则转发到位于应用程序服务器前端的弹性负载均衡（应用程序负载均衡器）。ElastiCache（Valkey）集群在 ALB 与数据库之间提供应用程序级缓存，用于存放频繁访问的产品数据。


**分配架构组件**  

| 组件 | 提供的内容 | 用途 | 
| --- | --- | --- | 
| CloudFront 分配 | 所有内容（单个域） | 全局边缘缓存、TLS 终止、通过缓存行为进行请求路由 | 
| Amazon S3 源（静态资产） | 产品图片、CSS、JS、字体 | 具有来源访问控制（OAC）的持久对象存储。具有长 TTL 的不可变内容。 | 
| ALB 源（动态内容） | 产品页面、搜索、API 端点 | 到应用程序服务器的路由。个性化内容的 TTL 较短，或不进行缓存。 | 
| ElastiCache 集群（Valkey） | 产品目录、库存数量、会话数据 | ALB 与数据库之间的应用程序级缓存。对频繁访问的数据进行亚毫秒级读取。 | 

## 电子商务的缓存行为
<a name="ecommerce-cache-behaviors"></a>

缓存行为决定了 CloudFront 如何根据 URL 路径模式处理请求。对于商城，请为每种内容类型配置单独的行为，并使用适当的缓存策略和 TTL。


**建议的缓存行为**  

| 路径模式 | Origin | TTL | 缓存策略 | 理由 | 
| --- | --- | --- | --- | --- | 
| `/static/*` | Amazon S3 | 365 天 | CachingOptimized | 版本化文件名（例如 `app.a1b2c3.js`）支持最大 TTL。从不需要缓存失效：使用新文件名部署新版本。 | 
| `/images/*` | Amazon S3 | 30 天 | CachingOptimized | 产品图片很少更改。当卖家更新图片时，使用缓存标签失效。TTL 比静态资源更低，因为图片 URL 可能会重用。 | 
| `/api/products/*` | ALB | 60 秒 | 自定义（包括查询字符串） | 产品列表和搜索 API 频繁更改，但可容忍短暂的过时。在缓存键中包含用于分页和筛选的查询字符串参数。 | 
| `/api/cart/*` | ALB | 0（无缓存） | CachingDisabled | 购物车操作特定于用户，必须始终到达源。完全禁用缓存。 | 
| `/api/inventory/*` | ALB | 5 秒 | 自定义（包括查询字符串） | 在销售事件期间，库存数量会迅速变化。极短的 TTL 可防止超售，同时降低源负载。 | 
| `Default (*)` | ALB | 0（无缓存） | CachingDisabled | 默认行为将未缓存的请求转发至应用程序，以执行服务器端渲染。包含个性化内容（推荐内容、用户名）的页面不应在边缘缓存。 | 

**注意**  
按从最具体到最不具体的顺序排列缓存行为。CloudFront 按列出的顺序评估路径模式，并使用第一个匹配项。将 `/api/cart/*` 置于 `/api/*` 之前，以确保购物车请求绕过缓存。

有关缓存行为的更多信息，请参阅[缓存行为设置](DownloadDistValuesCacheBehavior.md)。

## 商城内容的 TTL 策略
<a name="ecommerce-ttl-strategy"></a>

TTL 配置决定了 CloudFront 在源中检查更新之前，提供已缓存的内容达多长时间。电子商务应用程序需要采用不同的 TTL 策略，具体取决于内容新鲜度对客户体验的影响方式。

**不可变资产（CSS、JS、字体）**  
设置最大 TTL（365 天）。使用经过内容哈希处理的文件名，这样每次部署都会创建新的 URL。从不失效：旧版本会随着用户加载新文件名而自然过期。在源处设置 `Cache-Control: public, max-age=31536000, immutable`。

**产品图片**  
将 TTL 设置为 30 天，并在更新时使用缓存标记失效。当卖家上传新图片时，按产品的缓存标签（而非按路径）失效。这仅针对受影响的对象，而无需进行大范围的通配符失效。在源处设置 `Cache-Control: public, max-age=2592000`。

**产品目录 API**  
将 TTL 设置为 60 秒。产品列表、描述和定价可以容忍短暂的过期。这可以减少流量高峰（限时抢购、产品发布）期间的源负载，同时数据保持合理的时效性。设置 `Cache-Control: public, max-age=60, stale-while-revalidate=30` 以在 CloudFront 于后台获取最新响应的同时继续提供过期内容。

**库存和定价 API**  
将 TTL 设置为 5 秒。这些值频繁变化，并会影响购买决策。在流量高峰期间，极短的缓存仍可将源负载降低数个数量级：成千上万的并发用户看到的是相同的 5 秒缓存响应，而无需每个用户都直接请求源。

**特定于用户的内容（购物车、推荐内容）**  
禁用缓存（TTL = 0）。因用户而异的内容必须始终到达源。如果您错误地缓存了特定于用户的内容，CloudFront 可能会将一个用户的数据提供给另一个用户。对这些行为使用 `CachingDisabled` 托管策略。

## 源配置
<a name="ecommerce-origin-config"></a>

### Amazon S3 静态资产源
<a name="ecommerce-s3-origin"></a>

使用 Amazon S3 存储桶作为产品图片和静态资产的源。配置来源访问控制（OAC）以限制对存储桶的直接访问：所有请求都必须流经 CloudFront。


**Amazon S3 源设置**  

| 设置 | 值 | 理由 | 
| --- | --- | --- | 
| 源域 | `marketplace-assets.s3.amazonaws.com` | 使用 Amazon S3 REST API 端点（而非网站端点）以支持 OAC。 | 
| 源访问 | 来源访问控制（OAC） | 仅限 CloudFront 访问存储桶。阻止通过 S3 URL 直接访问您的资产。 | 
| 源护盾 | 已启用（最接近存储桶的区域） | 在边缘站点与源之间添加集中式缓存层。降低 S3 请求成本，并提高图片的缓存命中率。 | 
| 连接尝试次数 | 3 | 默认。在出现暂时性 S3 错误时进行重试。 | 

### 动态内容的 ALB 源
<a name="ecommerce-alb-origin"></a>

使用应用程序负载均衡器作为动态产品页面、搜索和 API 端点的源。ALB 路由到您的应用程序服务器（通过目标组路由到 Amazon EC2 实例、Amazon ECS 任务或 Lambda 函数）。


**ALB 源设置**  

| 设置 | 值 | 理由 | 
| --- | --- | --- | 
| 源域 | ALB DNS 名称 | 直接使用 ALB 的 DNS 名称。请勿使用 IP 地址：ALB IP 发生变化。 | 
| 协议 | 仅 HTTPS | 加密 CloudFront 与源之间的流量。对于敏感数据（用户会话、付款信息）为必需的。 | 
| 源自定义标头 | `X-Origin-Verify: <secret-value>` | 将 ALB 访问权限限制为来自 CloudFront 的请求。ALB 检查此标头并拒绝直接访问尝试。 | 
| 连接超时 | 10 秒 | 比默认值（30 秒）更短。在源出现问题时快速失效，而不是让边缘连接持续等待。 | 
| 响应超时 | 30 秒 | 为复杂的搜索查询和目录操作预留时间。如果您的 API 具有长时间运行的操作，请适当增大此值。 | 
| 保持活动状态超时 | 5 秒 | 重用与 ALB 的连接。减少后续请求的 TLS 握手开销。 | 

## 使用 ElastiCache（Valkey）的应用程序级缓存
<a name="ecommerce-elasticache"></a>

CloudFront 在边缘缓存内容，但对于需要数据库查询的频繁访问的数据，额外的应用程序级缓存将带来收益。运行 Valkey 的 ElastiCache 集群位于应用程序服务器与数据库之间，可为产品目录数据、库存数量和会话状态提供亚毫秒级读取性能。


**两层缓存策略**  

| 层 | 缓存的内容 | TTL | 缓存未命中行为 | 
| --- | --- | --- | --- | 
| CloudFront 边缘 | 完整的 HTTP 响应（API JSON、HTML 页面、图片） | 5 秒 – 365 天（按行为） | 将请求转发到 ALB 源 | 
| ElastiCache（Valkey） | 应用程序数据对象（产品记录、库存、会话） | 30 秒 – 5 分钟（按数据类型） | 应用程序查询数据库并将结果写入缓存 | 

对于产品页面请求：

1. CloudFront 检查其边缘缓存。命中时，立即返回缓存的响应。

1. 未命中时，CloudFront 转发至 ALB。

1. 应用程序检查 ElastiCache 中是否有产品数据。命中时，根据缓存的数据构建响应（亚毫秒）。

1. 在 ElastiCache 未命中时，查询数据库，写入 ElastiCache，然后返回响应。

1. CloudFront 根据行为的 TTL 设置在边缘缓存响应。

当卖家更新产品时：

1. 应用程序会使 ElastiCache 中的产品键失效。

1. 应用程序向 CloudFront 发送针对该产品标签的缓存标签失效。

1. 下一个请求会通过这两个缓存层触发新的响应。

## 常见问题
<a name="ecommerce-faq"></a>

以下各节解答了有关电子商务和商城工作负载的缓存策略的常见问题。

### 如何通过缓存处理个性化内容？
<a name="ecommerce-faq-personalization"></a>

将个性化元素与可缓存的内容分开。从 CloudFront 缓存提供页面框架（产品详情、图片、描述），并通过绕过缓存的客户端 API 调用加载个性化元素（推荐内容、购物车数量、用户名）。通过这种方法，您可以缓存开销较大的页面渲染，同时保持个性化内容的时效性。

### 如何在失效与短 TTL 之间做出选择？
<a name="ecommerce-faq-invalidation"></a>

对于频繁且可预测地发生变化的内容（如库存、定价），使用短 TTL（5–60 秒）。对于很少更改、但一旦更改必须立即更新的内容（如卖家编辑后的产品图片、合规性审查后的产品描述），使用失效。失效具有单次请求费用和并发限制：请勿将其用作合理 TTL 的替代方案。

### 如何为限时抢购和流量峰值做好准备？
<a name="ecommerce-faq-flash-sale"></a>

CloudFront 会自动扩展以应对流量峰值。为最大限度地提高促销期间的缓存命中率，请采取以下措施：在事件开始前预先请求产品页面以完成预热；暂时提高 API TTL（例如，将库存 TTL 从 5 秒提高到 15 秒）以在边缘吸收更多流量；并确保 ElastiCache 集群拥有充足的内存余量，以应对缓存写入量增加。在事件期间监控 CloudFront 缓存命中率指标。

### 我应该在我的商城中使用源护盾吗？
<a name="ecommerce-faq-multi-region"></a>

是。源护盾在区域性边缘缓存与源之间添加了一个集中式缓存层。对于电子商务工作负载，它可以减少对热门产品的源请求（因为源护盾的缓存命中可服务于所有边缘站点），降低图片的 S3 GET 成本，并平滑流向 ALB 的流量峰值。在距离您的源最近的区域中启用此功能。有关更多信息，请参阅 [使用 Amazon CloudFront Origin Shield](origin-shield.md)。