如何通过代码将Wagtail商品Snippet提交至工作流？

Wagtail后台操作Snippet时会自动触发工作流，但直接调用instance.save()或save_revision()这类模型方法，并不会自动启动工作流——得手动调用工作流相关API才行，具体实现如下：

1. 先确认Snippet的基础配置没问题 #

首先得确保你的商品Snippet已经正确开启工作流支持：

• 模型继承了DraftStateMixin和WorkflowMixin
• register_snippet装饰器里配置了正确的权限（比如can_create=True、can_edit=True）
• 后台已经给这个Snippet绑定了对应的工作流规则

2. 代码里手动触发工作流的两种方式 #

方式一：用Wagtail官方工作流API启动流程 #

from wagtail.core.workflow import WorkflowHandler

# 假设你的商品实例是product，操作的用户是request.user
# 第一步：先保存草稿版本
revision = product.save_revision(user=request.user)

# 第二步：启动工作流
WorkflowHandler.start_workflow(revision, user=request.user)

• 必须传user参数，工作流要记录操作人，不然会报错
• 一定要用save_revision()存草稿，工作流是基于草稿版本启动的，直接save()会跳过草稿和工作流

方式二：调用模型的提交审核方法 #

如果你的模型继承了WorkflowMixin，会自动拥有submit_for_moderation方法，直接调用就能模拟后台提交审核的逻辑：

# 先存草稿
revision = product.save_revision(user=request.user)
# 提交审核，自动启动工作流
product.submit_for_moderation(user=request.user)

这个方法内部已经封装了工作流启动的逻辑，和后台手动点“提交审核”效果完全一致

3. 几个要注意的点 #

• 所有操作必须传用户对象，工作流的权限和日志都依赖用户
• 绝对不能直接用save()更新实例，否则会直接修改数据库，跳过工作流审核环节
• 后台配置的工作流规则要匹配当前Snippet的状态，比如触发条件要符合，不然工作流也启动不了

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