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
      • Configuring Cache
      • Error Codes
    • Build Guide
    • Deployment Guide
      • Overview
      • Create Deploys
      • Manage Deploys
      • Deploy Button
      • Use Github Actions
      • Using CNB Plug-In
      • Using IDE Plug-In
    • Domain Management
      • Overview
      • Custom Domain
      • Configuring an HTTPS Certificate
      • How to Configure a DNS CNAME Record
    • Pages Functions
    • KV Storage
    • Edge AI
    • API Token
    • EdgeOne CLI
    • Pages MCP
    • Integration Guide
      • AI
        • Dialogue Large Models Integration
        • Images Large Models Integration
      • Database
        • Supabase Integration
        • Pages KV Integration
      • Ecommerce
        • Shopify Integration
        • WooCommerce Integration
      • Payment
        • Stripe Integration
        • Integrating Paddle
      • CMS
        • WordPress Integration
        • Contentful Integration
        • Sanity Integration
      • Authentication
        • Supabase Integration
        • Clerk Integration
    • Best Practices
      • Using General Large Model to Quickly Build AI Application
      • Using Edge AI Model to Quickly Build AI Site
      • Building an Ecommerce Platform with WordPress + WooCommerce and GatsbyJS
      • Building a SaaS Site Using Supabase and Stripe
      • Building a Company Brand Site Quickly
      • How to Quickly Build a Blog Site
    • Migration Guides
      • Migrating from Vercel to EdgeOne Pages
      • Migrating from Cloudflare Pages to EdgeOne Pages
      • Migrating from Netlify to EdgeOne Pages
    • Troubleshooting
    • FAQs
    • Contact Us
    • Release Notes

Troubleshooting

When using EdgeOne Pages, you may encounter various errors. This section focuses on errors that may occur when operating the Pages console and their solutions.


Building Deployment

Output Directory Exception

If the output directory is missing, empty, or invalid, the build process will raise an error (e.g., "Output directory build does not exist!"). To resolve this issue, you can try the following steps:
Ensure the correct output directory is set in Project Settings > Build Deployment Configuration.
If you are unsure about the output directory, run the build command locally and view the output location of the build artifacts.


Build Log Shows "The Account Storage Limit Is 5 GiB. Please Delete Some Deployments to Proceed"

Pages has a 5 GB storage capacity limit. Remove some deployment records and try again after deployment.


Build Log Shows "File Count Exceeds Project Limit"

The Pages Project has a limit of 20,000 files. Please troubleshoot and retry deployment later.


Build Log Shows "File Size Limit Exceeded. the Maximum Size for a Single File Is 25 MiB."

The Pages Project has a 25 MB size limit for single files. Please troubleshoot and retry later.


Direct Upload after Successful Deployment Page 404

Check if there is an index.html file in the root directory of the uploaded folder.



Domain Management

Incorrect DNS Record

After adding the DNS record with your domain provider, click "Verify" and the message "Your record is incorrectly configured. Please ensure it points to the correct address" appears. Since DNS records take some time to come into effect, you can wait a few minutes and verify again.
Note:
If the domain is hosted on Cloudflare, its root domain (for example, example.com) is temporarily unable to be added to Pages as a custom domain. We recommend using a subdomain (for example, sub.example.com).


Domain Exists on Other Platform

When adding a domain name, the message "The domain name already exists on another Tencent Cloud acceleration platform. Delete the rule and retry" appears. Try deleting the domain name on other platforms (Tencent Cloud CDN or EdgeOne) or use another second-level domain.


Platform Default Cert Deployment Timeout

When generating the default certificate, the certificate status shows "deployment timeout". Check whether the root domain of the added domain has a CAA record. You can temporarily remove the record and re-add the CAA record after certificate generation.


How to Achieve Non-Www to Www Auto-Jump

The redirects field can be configured in edgeone.json. For details, refer to the document Project Guide - edgeone.json.



Pages MCP

Deploy_html Tool Not Found

After adding the MCP Server, an error occurred: {"error": "MCP error -32602: MCP error -32602: Tool deploy_html not found"}. Try restarting the editor.


MCP Server Status Exception Displaying "Client Closed"

1.Try restarting the editor
2.If it's a Windows system, run as administrator: Right-click the editor icon and select "Run as administrator" to exclude issues caused by insufficient permissions.



Technical Support

If you encounter issues with no corresponding solution or need more technical guidance about Pages, join us on our Discord server EdgeOne Developers.