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.
