Skip to main content
Supported Regions:上海

FAQ

Access Issues​

What causes 514 errors when accessing static resources?​

Cause

The IP access frequency limit has been triggered. IP access frequency limiting is a restriction on the total number of requests for static hosting resources, not the number of requests for a single file. When a user accesses a web page, the browser simultaneously requests all static resources on the page (HTML, CSS, JS, images, etc.), and each resource counts toward the IP's access frequency statistics.

For example, suppose your web page contains:

  • 1 HTML file
  • 3 CSS files
  • 5 JS files
  • 10 image files

When users access the page, it generates 19 concurrent requests. If the IP access frequency limit is set to 2 QPS, then 17 requests will be rejected, returning a 514 error.

Solutions

  1. Check Page Resource Count

    • Use browser developer tools to view the number of network requests
    • Count the total number of resources during page load

  2. Adjust QPS Settings

    • Go to CloudBase Console → Environment Configuration → Security Control → Static Hosting Security Configuration
    • Set the QPS threshold to 1.5-2 times the number of page resources
    • For example: If the page has 20 resources, it is recommended to set QPS to 30-40

  3. Set by Page Type

    • Simple pages (5-10 resources): Recommended QPS 20-30
    • Regular websites (15-30 resources): Recommended QPS 50-80
    • Rich media pages (50+ resources): Recommended QPS 100-200
Note

Setting the QPS limit too low will affect the page loading experience for normal users. It is recommended to configure it reasonably based on actual business needs.

Build Issues​

Build fails with "command not found" error​

Cause

Missing necessary build tools or incorrect command spelling.

Solutions

  • Check if the corresponding script is defined in package.json
  • Confirm that the build command is spelled correctly
  • Check if required dependencies are installed

Build timeout​

Cause

Too many project dependencies or complex build process.

Solutions

  • Enable build cache
  • Optimize dependencies and remove unnecessary packages
  • Use a faster package manager (such as pnpm)

Deployment Path Issues​

Blank page or 404 after deployment​

Cause

Incorrect path configuration or routing mode issues.

Solutions

  • Check if base / publicPath configuration is correct
  • Single Page Applications (SPA) need to configure route redirects
  • Confirm that the output directory configuration is correct

Static resource 404​

Cause

Incorrect resource path references. Refer to Subpath Deployment Configuration

Solutions

  • Use relative paths to reference resources
  • Check if the base configuration matches the actual deployment path
  • Confirm that resource files have been correctly built to the output directory