创建B2C Commerce Developer Sandbox时遇RealmNotFound错误求助

错误原因解析 #

你遇到的404 RealmNotFound错误，核心原因是当前操作所指向的集群中不存在zzxp这个realm——哪怕realm本身处于激活状态，只要集群不匹配，就会触发该报错。

什么是Cluster？ #

Demandware的Cluster是承载沙箱、站点实例的服务器集群，不同集群对应不同地理区域（如北美、欧洲、亚太），每个realm会被绑定到特定集群运行。

查询集群信息的方法 #

1. 通过Business Manager查询 #

• 登录Business Manager，进入Administration > Organization > Organization Overview，页面中可直接查看当前realm绑定的集群ID及区域信息。
• 或进入Administration > Sites > Manage Sites，选中目标站点后，查看站点配置里的集群关联信息。

2. 通过OCAPI接口查询 #

调用系统实例信息接口，返回结果中的cluster_id字段即为当前集群ID：

GET /s/-/dw/data/v20_10/system/instance

（需使用具有系统权限的OCAPI凭据调用）

3. 查看历史邮件 #

当初创建zzxp realm或沙箱时，Salesforce发送的通知邮件中会明确标注该realm绑定的集群信息。

解决步骤 #

• 检查操作工具的集群指向：如果使用Demandware CLI，查看本地dw.json配置文件中的hostname字段，不同集群的域名后缀不同（如北美集群后缀为demandware.net，欧洲为demandware.eu），确保与zzxp realm绑定的集群一致。
• 切换到正确集群后，重新执行沙箱创建操作。
• 若无法确认zzxp绑定的集群，直接联系Salesforce B2C Commerce官方支持团队，提供realm ID即可查询对应集群信息。

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