<!-- Demox 发布失败排错 | 对照错误原文 -->
Source: https://www.demox.site/deploy-troubleshooting

部署排错 · 更新于 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](https://www.demox.site/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 及以上。
