meli故障排除与维护：常见问题解决方案大全

meli故障排除与维护：常见问题解决方案大全

【免费下载链接】meliPlatform for deploying static sites and frontend applications easily. Automatic SSL, deploy previews, reverse proxy, and more.项目地址: https://gitcode.com/gh_mirrors/me/meli

meli是一个用于轻松部署静态网站和前端应用的平台，提供自动SSL、部署预览、反向代理等功能。在使用过程中，可能会遇到各种问题，本文将为您提供常见问题的解决方案，帮助您快速解决meli使用过程中的故障。

SSL证书问题

SSL配置错误

如果您在使用meli的SSL功能时遇到问题，可能是SSL配置错误导致的。meli支持自动SSL配置，但有时可能会出现默认域名在ACME域名中缺失的情况。您可以检查caddy/config/ssl.ts文件中的SSL配置，确保域名设置正确。

SSL握手失败

SSL握手失败可能是由于证书无效或服务器配置问题引起的。您可以查看MongoDB错误代码，其中包含INVALID_SSL_CONFIGURATION（140）和SSL_HANDSHAKE_FAILED（141）等与SSL相关的错误代码。如果遇到这些错误，建议检查SSL证书的有效性和服务器的SSL配置。

通配符回退导致TLS错误

在某些情况下，通配符回退可能会导致TLS错误。meli的更新日志中提到曾修复过此问题，您可以参考相关的提交记录来解决类似问题。

部署问题

无法上传或删除logo

meli的更新日志中提到过无法上传或删除logo的问题，该问题已在后续版本中修复。如果您遇到类似问题，建议更新meli到最新版本。相关问题修复可参考CHANGELOG.md中的记录。

发布上传错误

在发布上传过程中，可能会遇到跨设备链接错误或序列化错误。您可以检查server/src/entities/releases/serialize-release.ts文件中的序列化逻辑，确保发布信息正确。

站点名称更新问题

有时站点名称更新可能会出现问题，这可能与数据库索引或缓存有关。您可以尝试重启meli服务或检查数据库索引配置，相关代码可参考server/src/db/indexes/目录下的文件。

域名和代理问题

自定义域名上的分支暴露问题

meli支持在自定义域名上暴露分支，您可以在server/src/caddy/config/sites/generate-site-routes.ts文件中查看相关配置。如果遇到分支无法在自定义域名上访问的问题，建议检查路由配置是否正确。

反向代理自动HTTPS禁用

如果需要为反向代理禁用自动HTTPS，可以在配置中进行设置。相关代码可参考server/src/caddy/config/api-route.ts和server/src/caddy/config/ui-route.ts中的反向代理配置。

域名解析问题

如果遇到域名无法解析的问题，建议检查域名的DNS设置，并确保meli的默认站点域名已设置为主机。相关配置可参考server/src/entities/sites/get-site-main-domain.ts文件。

数据库问题

MongoDB连接错误

MongoDB连接错误可能是由于环境变量配置不正确导致的。您可以检查server/src/db/build-mongo-uri.ts文件中的连接逻辑，确保MongoDB的主机、端口和数据库名称等参数正确设置。

数据库索引错误

数据库索引错误可能会导致数据操作失败。meli提供了数据库索引配置功能，相关代码可参考server/src/db/indexes/目录下的文件。如果遇到索引错误，可以尝试重新配置索引或检查数据格式。

重复索引键错误

重复索引键错误可能是由于数据重复插入导致的。您可以检查server/src/db/indexes/mongo-error-code.ts中的错误代码，了解具体的错误原因，并相应地调整数据或索引。

维护与更新

定期更新meli

为了避免遇到已知问题，建议定期更新meli到最新版本。您可以通过查看CHANGELOG.md了解最新的功能改进和问题修复。

错误日志查看

当遇到问题时，查看错误日志是解决问题的重要步骤。meli提供了错误日志增强功能，您可以在server/src/utils/enhance-error-logging.ts中查看相关配置，以便更好地追踪和解决问题。

数据库备份

定期备份数据库是保障数据安全的重要措施。您可以使用meli提供的数据库迁移工具，相关代码可参考server/src/db/migrate/目录下的文件，确保数据的安全性和可恢复性。

通过以上常见问题的解决方案，您可以更好地使用meli平台部署和管理静态网站和前端应用。如果遇到其他问题，建议查看官方文档或提交issue寻求帮助。

【免费下载链接】meliPlatform for deploying static sites and frontend applications easily. Automatic SSL, deploy previews, reverse proxy, and more.项目地址: https://gitcode.com/gh_mirrors/me/meli