部署排错 · 更新于 2026-09-14 · Demox 团队

Demox 发布失败时，该看哪一条错误？

直接答案：先读失败信息里的 code 和原文。缺根目录 index.html 是 MISSING_ENTRYPOINT。包无法当静态站点打开是 INVALID_STATIC_SITE。命中屏蔽词是 CONTENT_BLOCKED，文案会写出具体词。私有站点未授权是 Access denied。functions push 成功但页面仍旧，是因为 push 不改别名。

缺少根目录 index.html

code：MISSING_ENTRYPOINT。原文：Artifact 缺少根目录 index.html。把 index.html 放到上传目录或 ZIP 根目录；React/Vue 先构建。

内容审核拦截

code：CONTENT_BLOCKED。原文：发布失败：{文件} 未通过安全审核，文件名或文件内容含有违规词「{词}」。请修改后重试。改掉写出的那个词。词表：/content-scan 或 GET https://api.demox.site/website/content-scan/phrases。

私有站点 Access denied

未登录会跳登录；登录后仍无权限则返回 Access denied。把访问者加成项目成员，或改回公开。

push 之后仍是旧逻辑

push 只创建版本。执行 demox functions alias set --id 站点ID --slug 标识 production --version N。CLI 需要 1.1.6 及以上。