[仅限PaaS]{class="badge informative" title="仅适用于云项目（Adobe管理的PaaS基础架构）和内部部署项目上的Adobe Commerce 。"}
SaaS Data Export的疑难解答方案
本页介绍在使用SaaS Data Export时可能观察到的行为，这些行为通常是由错误配置或错误解释同步结果造成的。 使用以下说明确定根本原因并应用相应的解决方案。
Commerce服务中缺少可配置或捆绑产品 configurable-bundle-missing
问题：可配置或捆绑产品在Adobe Commerce中处于 已启用 状态，但未在店面中返回或在Commerce SaaS服务中显示为 已禁用 状态。
原因：复合产品的有效状态取决于其子产品的状态，而不只是父产品的状态。 Commerce SaaS服务反映此计算状态：
- 可配置产品 — 必须至少启用一个产品变体。
- 捆绑产品 — 必须为每个所需的捆绑选项至少启用一个产品。
如果不满足这些条件，则父产品将被视为已禁用，即使其自身状态设置为 已启用 也是如此。
解决方案：
- 对于可配置产品，验证是否已启用至少一个关联的简单产品变体，并将其分配给正确的网站和商店视图。
- 对于捆绑产品，请检查每个所需的捆绑选项是否至少具有一个已启用的子产品。 对于所有已禁用的子级，必填选项会导致整个捆绑被视为已禁用。
- 启用相应的子产品后，触发重新同步或等待下一个计划同步，然后在Commerce SaaS服务中确认已更新状态。
目录价格规则激活后未更新价格 prices-not-updated
问题：使用“计划更新”功能激活目录价格规则后，价格不会更新。 在应用计划的更新后，commerce-data-export.log显示prices信息源的synced: 0。
原因：当计划的更新用于目录价格规则时，cron组之间可能会出现争用情况。 catalog_data_exporter_product_prices索引器可能在其依赖项catalogrule_product索引完成重建之前运行。 因此，价格导出程序会读取陈旧数据，并且不会导出任何更改。
解决方案：
此问题的直接解决方法是：将两个cron组配置为按顺序运行以消除争用情况：
-
转到Stores > Configuration > Advanced > System > Cron (Scheduled Tasks)。
-
将 Use Separate Process 设置为No：
- 组 index 的Cron配置选项
- 组 staging 的Cron配置选项
-
保存后刷新配置缓存。
Adobe Commerce与连接的服务之间的目录数据不一致 catalog-data-discrepancy
问题：连接的Commerce服务中显示的产品数据（如Live Search或Product Recommendations）与Adobe Commerce中的目录数据不匹配。 例如，产品名称、价格或说明在店面中显示为过时或不正确。
原因：触发重新同步后，可能需要长达一小时的时间来更新数据并将其反映在UI组件中。 如果差异持续存在到该窗口之外，则上次同步可能未提取该项目，或者同步未检测到更改，因为信息源数据已标记为最新。
解决方案：
- 从Commerce店面，打开搜索结果。 然后，选择相关产品以打开其详细视图。
- 复制JSON输出，并确认它与Commerce目录中的内容匹配。
- 如果内容不匹配，请在目录中对产品进行细微编辑，如添加空格或句点，以强制检测更改。
- 等待重新同步或触发从CLI或Admin中的Data Feed Sync Status页面手动重新同步。
有关Product Recommendations中目录数据的其他疑难解答，请参阅Commerce知识库中的产品推荐模块疑难解答。
数据同步未按计划运行 sync-not-on-schedule
问题：数据同步未按计划运行，或者未同步任何项目，尽管Adobe Commerce中的产品发生了更改。
原因：最常见的原因是cron作业未运行或未在 Update by Schedule 模式下配置索引器。
解决方案：
- 确认cron作业正在运行。
- 验证以下源的索引器是否设置为Update by Schedule：目录属性、产品、产品覆盖和产品变体。 在Commerce管理员中或使用CLI从Index Management检查：
bin/magento indexer:show-mode | grep -i feed。
目录同步的状态为失败 catalog-sync-failed
问题：目录同步在 Data Feed Sync Status 页面上显示 失败 状态。
原因：数据收集或提交阶段出现不可恢复的错误。 常见原因包括API身份验证问题、网络错误或数据验证失败。
解决方案：
日志显示“操作已跳过 — 进程已锁定”消息 process-locked
问题： commerce-data-export.log文件包含类似以下内容的条目：
{"feed":"products","operation":"partial sync","status":"operation skipped - process locked by \"full sync(1234)\"", ...}
原因：这是预期行为，而不是错误。 在完全重新索引或saas:resync已在进行时，cron触发的部分同步尝试运行，将显示该消息。 SaaS Data Export扩展使用馈送锁定机制来防止发生冲突的并发同步操作。
解决方案：
无需执行任何操作。 运行进程完成并释放锁定后，下一个cron执行将选取并同步所有挂起的更改。 有关锁定机制工作方式的详细信息，请参阅用于SaaS数据导出的馈送锁定机制。