
超时只表示没有及时收到结果,不证明创建失败。批量内容应使用稳定任务标识并保存文章ID,重试前查询真实状态;标题相同或slug被自动加数字都不能作为可靠的幂等保障。
为内容准备稳定身份
写作编号、来源文档标识或内部任务键应在重试时保持不变,不用会改变的标题作为唯一依据。记录目标站点及预期内容类型,避免同一编号跨站串用。标识本身不应包含客户秘密或签名下载链接。
先查已有结果再决定创建
创建前检查任务映射,发生超时后再次查询目标站实际记录。WordPress可能为冲突slug自动生成变体,因此“原slug不存在”也需结合已有ID和记录判断。不要每次重跑都调用创建接口,让系统自动加后缀作为所谓防冲突措施。

及时保存创建返回的信息
取得文章ID后将其与任务及内容版本关联,再进行配图、分类和审核。某个后续步骤失败时,应继续更新同一文章,而不是重新创建正文。对于并发任务,需要采用能防止同时创建的协调方式,不能只靠两边各自先查询一次。
区分草稿生成与公开发布
先建立可审查内容及完整状态,再按授权发布。重试时检查当前状态,避免把已审核正文又覆盖为旧草稿,或对同篇反复更新日期。最终核对重复记录和公开入口,保留异常处理记录,防止搜索与读者遇到两份冲突内容。
关键区别

超时:未及时收到结果;不能推断创建失败。
稳定标识:关联同一内容任务;标题可能后续变化。
文章ID:已创建对象身份;后续步骤应复用。
怎样确认处理到位
同一任务重试后仍只有预期文章,后续配图和审核复用正确ID,公开状态与授权一致,重复及冲突记录已处理。
容易误判的边界
WP-CLI创建命令本身不应被视为自动幂等服务;单靠先查再建也不能避免并发竞态,需要与流程协调配合。
