最佳实践

本页汇总 ShopFaaS 运营与开发的最佳实践，帮助商家与开发者避开常见坑、提升效率与稳定性。

商品管理

商品信息优化

库存管理

集合（分类）组织

• 主导航 3–7 个集合：过多会让客户迷失
• 自动集合：按标签或条件自动归类（如「新品」=创建时间 30 天内）
• 手动集合：用于精选、促销等需要人工挑选的场景
• 集合封面与描述：提升 SEO 与视觉一致性

订单履约

履约时效

退款与退货

营销与折扣

折扣码策略

弃单召回

• 首次召回：弃单后 1 小时发送，提醒完成结账
• 二次召回：弃单后 24 小时发送，附 5% 折扣码
• 停止召回：已下过同 SKU 订单的客户不再召回
• A/B 测试：测试不同邮件标题与发送时间，优化转化率

SEO 优化

技术 SEO

内容 SEO

• 博客内容：每周 1–2 篇行业相关文章，吸引长尾流量
• 商品描述：原创描述，避免直接使用供应商文案（重复内容降权）
• Alt 文本：每张商品图片添加描述性 alt 文本
• 内链：博客文章链接到相关商品，商品页链接到相关集合

性能调优

前台性能

后台性能

• 批量操作用后台提供的批量功能，避免单条循环
• 大数据量导出用 CSV 而非页面渲染
• 私有化部署用户定期清理审计日志（保留 90 天即可）

安全加固

私有化部署安全清单

API Key 安全

应用扩展开发规范

权限最小化

// ✅ 正确：仅声明实际使用的权限
{
  "permissions": ["order:view"]
}

// ❌ 错误：声明了不需要的权限（审核会拒绝）
{
  "permissions": ["order:view", "order:fulfill", "order:refund", "product:view"]
}

错误处理

// ✅ 正确：捕获错误并返回有意义的消息
const handler: WebhookHandler<"order.created"> = async (event, ctx) => {
  try {
    const order = await ctx.api.orders.get(event.payload.order_id);
    await sendNotification(order);
  } catch (error) {
    ctx.logger.error("订单通知发送失败", { orderId: event.payload.order_id, error });
    throw error; // 抛出错误让平台重试
  }
};

// ❌ 错误：吞掉错误，问题无法被发现
const handler: WebhookHandler<"order.created"> = async (event, ctx) => {
  try {
    const order = await ctx.api.orders.get(event.payload.order_id);
    await sendNotification(order);
  } catch (error) {
    // 什么都不做
  }
};

幂等性

性能要求

多店铺运营

统一品牌 vs 独立品牌

数据隔离与共享

• 隔离：商品、订单、客户、营销按店铺隔离，避免互相影响
• 共享：主题、应用可跨店铺复用（每个店铺独立安装配置）
• 不共享：ShopFaaS 不提供跨店铺数据汇总，需通过 API 导出后在外部汇总

相关文档