Edge Developer Platform
  • Pages
    • Product Introduction
    • Quick Start
      • Importing a Git Repository
      • Starting From a Template
      • Direct Upload
    • Framework Guide
    • Project Guide
      • Project Management
      • edgeone.json
      • Error Codes
    • Build Guide
    • Deployment Guide
      • Overview
      • Create Deploys
      • Manage Deploys
      • Deploy Button
    • Domain Management
      • Overview
      • Custom Domain Name
      • Configuring an HTTPS Certificate
      • How to Configure a DNS CNAME Record
    • Pages Functions
    • KV Storage
    • Edge AI
    • EdgeOne CLI
    • Pages MCP
    • Best Practices
      • 1-Minute Quick Deployment + Free Beta Test in Progress | Your Exclusive DeepSeek, Handled by EdgeOne!
      • Deploy WordPress Gatsby To EdgeOne Pages
      • Build an Ecommerce Platform Using WordPress + GatsbyJS
      • Combining Sanity to Deploy a Portfolio Template
    • Migration Guides
      • Migrating from Vercel to EdgeOne Pages
      • Migrating from Cloudflare Pages to EdgeOne Pages
      • Migrating from Netlify to EdgeOne Pages
    • FAQs
    • Contact Us
    • Release Notes
Unlock 1 Year of EdgeOne + 1TB CDN: Join Our Developer Journey
Get Started Now !

Error Codes

When using Pages to develop projects, you may encounter various errors. When there is a problem accessing your site, the page will display error codes and brief descriptions. These errors may involve project-level access issues or deployment-level status exceptions. This chapter will provide specific solutions for common error situations.


Error Code List

Error Codes
Overview
401
Authentication information expired. Please generate the preview URL again.
404
This site does not exist. Check your access address.
410
This deployment has been deleted. Please redeploy.
423
The project is being deployed. Please wait to view.
424
Project deployment failed. View the deployment record to get more information.
451
The project has been banned. The website is not available now.


Error Code Details

401 - Authentication Information Expired

To ensure content compliance, accessing Pages sites via project domain name and deployment domain needs to follow the following rules:

1. The acceleration region of the project is set to "Chinese mainland availability zone" or "global availability zone (including Chinese mainland)".
1.1 Use the system-generated preview URL for access. The link validity period is 3 hours. A 401 error will be returned after timeout.
1.2 Regularly update the valid link via the "Preview" button in the upper right corner of the "Project Overview" interface on the console.
2. The acceleration region of the project is set to "global availability zone (excluding Chinese mainland)".
2.1 Non-Chinese mainland network environments can directly access it. A 401 error will be returned in Chinese mainland network environments.

It is recommended to bind Custom Domain to establish a stable access channel. No record filing is required in global availability zones (excluding Chinese mainland).


404 - Site Does Not Exist

Please confirm whether the project domain or deployment domain you are accessing is correct.


410 - Deployment Deleted

When you delete a deployment record and then try again to access the deployment domain, a 410 error will be returned. The deployment may be deleted due to version update, resource optimization or management need. The deleted deployment cannot be recovered. You can choose to create a new deployment.


423 - Project Is Being Deployed

If the project is undergoing first deployment, wait patiently until after deployment is completed and then visit again. If it is not the first deployment, you can still access the project, but you will see the old version. After the new deployment is completed, the latest version can be accessed.


424 - Deployment Failure

A 424 error will occur if there are errors or other reasons during the project build process that cause deployment failure.
Common failure reasons include:
Build script error
Dependency miss or version incompatibility
Resource limits (such as insufficient memory)
Please view the detailed deployment record of the corresponding project in the console to obtain logs and understand the specific reason for failure. After fixing issues, you can recreate the deployment.


451 - Project Has Been Banned

The project has been banned and cannot be accessed due to violation of platform rules, such as involving illegal content (involving pornography, politics, etc.). Please ensure that your content complies with laws and regulations and platform regulations. If you consider this a misjudgment, please contact us through the community or customer service to get more information.



FAQs

Q: I encountered error codes not mentioned above. What should I do?
A: If you encounter error codes not covered in the document, record the error code and your steps, then contact us for help.


Q: How to prevent 401 errors caused by the expiration of the preview URL?
A: The best method is to add a custom domain to your project. This way, you can ensure you can always access your project through that domain, independent of the timeliness of the preview URL.


Q: My project has been displaying a 423 error (being deployed), but it seems to have lasted for a long time. Is this normal?
A: Normally, the deployment process should be completed within minutes. If you find the deployment time unusually long, suggest checking your deployment log to see if there is any error information. If the problem persists, contact us.