目录
介绍
当尝试在 Magento 2 上保存管理后台集成时遇到“404 错误：页面未找到”时，这可能对开发人员和电子商务管理员来说是一种令人沮丧的体验。这个常见问题，尤其在 Magento 2.4.6-p3 等版本中经常出现，会中断重要第三方服务的集成，并可能导致网站功能停止。
在这篇详细的指南中，我们将剖析这个错误背后的原因，并提供可行的解决方案来解决它。无论你是经验丰富的 Magento 开发人员还是一个希望快速解决这个问题的商店管理员，本文都将为你提供解决 Magento 2 中的“404 错误”问题所需的知识。
通过本文末尾，你将全面了解这个错误可能的原因，并了解到解决该问题所需的步骤。我们还将提及一些预防措施，以避免在将来遇到类似的问题。
了解 Magento 2 管理后台集成 404 错误
什么是 404 错误？
404 错误是一个 HTTP 状态代码，表示服务器无法找到请求的资源。在 Magento 2 的上下文中，当应用无法找到用于集成的特定页面或文件时，会显示该错误消息。
为什么 Magento 2 管理后台集成会出现 404 错误？
404 错误可能出现的原因有很多：
- URL 重写不正确：Magento 在生成 SEO 友好的 URL 时广泛使用 URL 重写，当这些重写失败或配置不正确时，就会导致 404 错误。
- 配置问题：Magento 的管理后台面板中的配置设置不正确可能导致集成端点无法访问。
- 缓存问题：旧的或损坏的缓存文件也可能导致 404 错误，因为 Magento 可能提供过时的信息。
- 文件和文件夹权限：权限不正确可能会阻止服务器访问所需的文件和目录。
- 扩展冲突：已安装的第三方扩展或主题可能与默认的 Magento 设置冲突，从而改变 URL 结构。
逐步解决 404 错误的方法
1. 验证 URL 重写
确保在 Magento 中启用了 URL 重写。按照以下步骤验证和校正 URL 重写：
- 转到
存储 > 配置 > 常规 > Web。 - 在 URL 选项 选项卡下，验证 使用 Web 服务器重写 是否设置为 是。
- 通过转到
系统 > 缓存管理，然后点击 刷新 Magento 缓存来清除 Magento 缓存。
2. 检查后台 URL 配置
不正确的后台 URL 设置可能导致 404 错误。验证后台 URL 设置是否正确：
- 打开位于
app/etc目录中的env.php文件。 - 检查
admin部分，并确保 URL 正确：'backend' => [ 'frontName' => 'admin' ],
3. 刷新索引和缓存
过时的索引和缓存文件可能导致 404 错误。刷新它们以确保 Magento 提供最新数据：
- 转到
系统 > 索引管理。 - 选择所有索引，并选择 重新索引数据 选项。
- 通过转到
系统 > 缓存管理来清除缓存。
4. 检查文件和文件夹权限
确保 Magento 的文件和文件夹权限允许必要的访问：
- 将文件权限设置为 644，将文件夹权限设置为 755：
find . -type f -exec chmod 644 {} \; find . -type d -exec chmod 755 {} \;
5. 禁用第三方扩展
有时候第三方扩展可能会干扰 Magento 的默认功能。禁用最近安装的任何扩展：
- 通过 SSH 登录到 Magento 服务器。
- 使用以下命令禁用特定扩展：
bin/magento module:disable Vendor_ModuleName - 禁用扩展后刷新缓存：
bin/magento cache:flush
6. 检查服务器配置
确保服务器已正确配置以支持 Magento：
-
Apache/Nginx 配置： 确保 Apache 或 Nginx 的虚拟主机配置正确，能够处理 Magento 的 URL 结构。 例如，在 Nginx 中：
location / { try_files $uri $uri/ /index.php?$args; } -
PHP 设置： 请确保 PHP 设置（如 memory_limit、max_execution_time 和 post_max_size）对于 Magento 来说是正确的。
7. 检查 Magento 日志
Magento 会记录日志，可以提供关于 404 错误的信息：
- 转到
var/log目录。 - 查看
exception.log和system.log是否有关于管理后台集成尝试的错误消息。
8. 如有必要重新安装 Magento
如果错误仍然存在，作为最后的手段，考虑重新安装 Magento。这一步只有在已经进行了足够的备份并且其他故障排除方法失败的情况下才应该采取。
预防措施
为了避免将来遇到类似问题：
- 定期更新：保持 Magento 及其扩展程序的最新状态，以确保兼容性和安全性。
- 定期备份：定期备份 Magento 网站，以便在出现问题时轻松恢复到之前的状态。
- 测试环境：维护一个演练环境，以在将更改应用到生产站点之前对其进行测试。
结论
解决 Magento 2 管理后台集成 404 错误需要一系列系统性的检查和纠正操作。通过遵循本指南中概述的步骤，您可以诊断和解决错误，确保在 Magento 设置中实现平稳和连续的集成。请记住，保持 Magento 安装的良好维护和更新对于避免此类问题至关重要。
常见问题解答
问：如果在尝试了所有这些解决方法之后，404 错误仍然存在，我该怎么办？
答：如果错误仍然存在，请考虑寻求专业的 Magento 开发人员的帮助，或者联系 Magento 支持以获得更个性化的帮助。
问：禁用缓存可以解决 404 错误吗？
答：禁用缓存有时可以帮助确定问题是否与过时或损坏的缓存文件有关，但这不是一个永久解决方案。推荐进行适当的缓存管理和刷新。
问：我应该多久更新一次我的 Magento 安装和扩展程序？
答：通常每隔几个月就应该进行常规更新，以确保兼容性和安全性。
