Troubleshooting
When using EdgeOne Makers, you may encounter various errors. This section focuses on errors that may occur when the Makers console is operated 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"
Makers has a 5 GB storage capacity limit. Delete some deployment records and then retry the deployment.
Build Log Shows "File Count Exceeds Project Limit"
Makers projects have a limit of 20,000 files. Troubleshoot the issue and then retry the deployment.
Build Log Shows "File Size Limit Exceeded. the Maximum Size for a Single File Is 25 MiB."
Makers projects have a 25 MB size limit per file. Troubleshoot the issue and then retry the deployment.
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 a domain is hosted on Cloudflare, its root domain (for example, example.com) cannot be added to Makers as a custom domain for now. 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.Makers 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 the issue you encounter has no corresponding solution, or if you need more technical guidance on Makers, you can join our Discord server EdgeOne Developers.
