跳到主要内容
支持地域：上海

常见问题

访问问题​

静态资源访问时出现 514 错误是什么原因？​

原因

触发了 IP 访问限频配置。IP 访问限频是针对静态托管资源请求的总次数限制，而不是单个文件的请求次数限制。当用户访问一个网页时，浏览器会同时请求页面中的所有静态资源（HTML、CSS、JS、图片等），每个资源都会计入该 IP 的访问频率统计。

例如，假设您的网页包含：

  • 1 个 HTML 文件
  • 3 个 CSS 文件
  • 5 个 JS 文件
  • 10 个图片文件

用户访问时会产生 19 个并发请求。如果 IP 访问限频设置为 2 QPS，那么会有 17 个请求被拒绝，返回 514 错误。

解决方案

  1. 检查页面资源数量

    • 使用浏览器开发者工具查看网络请求数量
    • 统计页面加载时的总资源数

  2. 调整 QPS 设置

    • 进入云开发控制台 → 环境配置 → 安全管控 → 静态托管安全配置
    • 将 QPS 阈值设置为页面资源数的 1.5-2 倍
    • 例如：页面有 20 个资源，建议设置 QPS 为 30-40

  3. 分页面类型设置

    • 简单页面（5-10 个资源）：建议 QPS 20-30
    • 普通网站（15-30 个资源）：建议 QPS 50-80
    • 富媒体页面（50+ 个资源）：建议 QPS 100-200
注意

设置过低的 QPS 限制会影响正常用户的页面加载体验，建议根据实际业务需求合理配置。

构建问题​

构建失败，提示 "command not found"​

原因

缺少必要的构建工具或命令拼写错误。

解决方案

  • 检查 package.json 中是否定义了对应的 script
  • 确认构建命令拼写正确
  • 检查是否安装了所需的依赖

构建超时​

原因

项目依赖过多或构建过程复杂。

解决方案

  • 开启构建缓存
  • 优化依赖，移除不必要的包
  • 使用更快的包管理器（如 pnpm）

部署路径问题​

部署后页面空白或 404​

原因

路径配置不正确或路由模式问题。

解决方案

  • 检查 base / publicPath 配置是否正确
  • 单页应用（SPA）需要配置路由重定向
  • 确认输出目录配置正确

静态资源 404​

原因

资源路径引用错误。

解决方案

  • 使用相对路径引用资源
  • 检查 base 配置是否与实际部署路径一致
  • 确认资源文件已正确构建到输出目录