VTEX 平台中产品创建为何跨工作区同步？原因与解决方案_技术教程

在 vtex 平台中，产品数据不按工作区（workspace）隔离，所有工作区共享同一套商品目录；因此，在开发工作区创建的产品会自动出现在主工作区（master），这是平台默认行为，而非配置错误。

VTEX 的 Catalog（商品目录）服务采用全局数据模型设计：产品（Product）、SKU、Category、Brand 等核心实体均属于账户（Account）级别资源，与工作区无关。这意味着无论您登录 dev.myaccount.vtexcommercestable.com 还是 master.myaccount.vtexcommercestable.com，后台调用的都是同一套 Catalog API（如 /api/catalog/pvt/product），数据写入后即对全工作区可见。

✅ 正确理解：

工作区（workspace）主要用于隔离代码部署（IO Apps、Store Theme、CMS blocks）和订单/用户会话上下文；
但商品、库存、价格、分类等业务数据始终全局共享；
因此，“在 dev 创建产品却出现在 master”不是 bug，而是 VTEX 架构的明确设计。

⚠️ 常见误区与风险：

误以为开发工作区具备“数据沙箱”能力，直接在 dev 中批量导入测试商品 → 导致 master 环境出现脏数据、影响线上搜索与推荐；
未区分环境执行自动化脚本（如通过 vtex api 或 Postman 调用 /catalog/pvt/product）→ 全局生效，无回滚机制。

? 安全实践建议：

严格使用 QA 账户进行目录测试
VTEX 推荐为非生产环境单独配置一个独立的 QA Account（如 qa-mybrand.vtexcommercestable.com），其 Catalog 数据与生产账户物理隔离，可自由增删改查而不影响 master。
开发阶段避免手动创建真实商品
- 使用虚拟 SKU（如 TEST-SKU-001）并添加明显标识（如 productName: "[DEV ONLY] Wireless Headphones"）；
- 在 CMS 或 Store Theme 中通过条件逻辑隐藏测试商品（例如检查 context.workspace === 'dev'）；
- 利用 VTEX Mock API 或本地 JSON Server 模拟商品响应，绕过真实 Catalog 写入。
自动化流程中显式管控环境
若需通过脚本管理商品，务必结合 Account + Workspace 鉴权，并优先使用只读接口（如 GET /catalog/system/pvt/product/{id}）做验证；写操作前强制校验当前 Account 是否为预设的测试账户：

# 示例：仅允许在 QA 账户执行创建（需提前配置 VTEX_AUTH_TOKEN）
ACCOUNT="qa-mybrand"
WORKSPACE="dev"

if [[ "$ACCOUNT" == "qa-mybrand" ]]; then
  vtex api POST /catalog/pvt/product \
    -H "Content-Type: application/json" \
    -d '{"productName":"[QA] Sample Product", "items":[{"sku":"QA-SKU-001"}]}'
else
  echo "❌ Refused: Product creation is disabled for non-QA accounts."
  exit 1
fi