开发常见问答01：为什么写操作会返回 403（CSRF 校验失败）？
解释 WooCMS 写接口 CSRF 机制与排查动作。
更新时间：2026-02-26 18:47:36.72372 +0000 UTC
分类专题
常见问题
共 10 篇已发布文章
开发常见问答02：为什么接口提示权限不足？
梳理 authRequired 与 permissionRequiredInSite 的排查路径。
更新时间：2026-02-26 18:47:36.72372 +0000 UTC
开发常见问答03：主题已激活但前台没变化怎么办？
从 template_key、站点上下文、缓存与回退链定位主题不生效问题。
更新时间：2026-02-26 18:47:36.72372 +0000 UTC
开发常见问答04：插件已启用但 Hook 没执行？
从事件名、hook type、权限、失败策略四个层面做定位。
更新时间：2026-02-26 18:47:36.72372 +0000 UTC
开发常见问答05：数据库迁移执行失败如何处理？
给出“停扩展、查偏差、修复后重放”的迁移故障处理流程。
更新时间：2026-02-26 18:47:36.72372 +0000 UTC
开发常见问答06：如何正确执行大更改后的发布动作？
根据开发规范总结大更改后的必做动作：迁移、重编译、重启、冒烟。
更新时间：2026-02-26 18:47:36.72372 +0000 UTC
开发常见问答07：多站点下内容为什么“看得到但查不到”？
解释 site_id 作用域导致的数据可见性差异，给出统一排查方法。
更新时间：2026-02-26 18:47:36.72372 +0000 UTC
开发常见问答08：缓存导致页面内容不更新怎么办？
介绍路由与内容缓存键失效策略，避免“发布成功但前台旧内容”。
更新时间：2026-02-26 18:47:36.72372 +0000 UTC
开发常见问答09：如何判断是主题问题还是插件问题？
给出分层定位法：先模板回退链，再 Hook 观测链，快速缩小范围。
更新时间：2026-02-26 18:47:36.72372 +0000 UTC
开发常见问答10：开发任务结束前必须更新哪些文档？
汇总规范要求的文档更新闭环，避免“代码改了但台账缺失”。
更新时间：2026-02-26 18:47:36.72372 +0000 UTC