Yii2 CRUD 生成后 URL 访问 404 错误排查与解决

本文旨在帮助开发者解决在使用 Yii2 Gii 生成 CRUD 后，通过 URL 访问对应模型时出现 404 错误的问题。文章将分析常见原因，并提供详细的排查步骤和解决方案，确保 CRUD 功能正常访问。

在使用 Yii2 框架的 Gii 工具生成 CRUD (Create, Read, Update, Delete) 功能后，有时会遇到通过 URL 访问时出现 404 错误的情况。这通常是由于配置不当或文件放置位置错误导致的。以下是一些常见的排查和解决步骤：

1. 检查 URL 管理器配置

首先，确认 urlManager 组件已正确配置。urlManager 负责将友好的 URL 映射到实际的控制器和操作。在 config/web.php 或 config/main.php 文件中，找到 urlManager 的配置，并确保以下几点：

• enablePrettyUrl 设置为 true，启用美化 URL。
• showScriptName 设置为 false，隐藏 URL 中的 index.php。
• rules 数组可以为空，或者包含自定义的 URL 规则。如果包含自定义规则，请确保没有规则与你的 CRUD URL 冲突。

示例配置：

'components' => [
    'urlManager' => [
        'enablePrettyUrl' => true,
        'showScriptName' => false,
        'rules' => [
            // 可以添加自定义规则，例如：
            // '<controller:\w+>/<id:\d+>' => '<controller>/view',
        ],
    ],
],

2. 确认控制器和模型已正确生成

确保控制器（例如 ProductController）和模型（例如 Product）已成功生成，并且位于正确的位置。

• 控制器通常位于 controllers 目录下，例如 backend/controllers 或 frontend/controllers。
• 模型通常位于 models 目录下，例如 common/models 或 backend/models。

3. 检查视图文件位置

这是最常见的问题所在。Gii 生成的视图文件（_form.php, _search.php, create.php, index.php, update.php, view.php）应该位于与控制器同名的目录下，该目录位于 views 目录下。

例如，如果控制器是 ProductController，那么视图文件应该位于 views/product 目录下，而不是 views/layouts 目录下。views/layouts 目录用于存放布局文件，而不是 CRUD 视图。

正确的目录结构应该是：

views/
  product/
    _form.php
    _search.php
    create.php
    index.php
    update.php
    view.php

4. 检查控制器命名空间

挖错网

一款支持文本、图片、视频纠错和AIGC检测的内容审核校对平台。

28

查看详情

确保控制器的命名空间与文件路径一致。例如，如果控制器位于 backend/controllers 目录下，并且命名空间是 backend\controllers，那么控制器的完整类名应该是 backend\controllers\ProductController。

5. 检查控制器操作方法

确保控制器中存在与 CRUD 操作对应的操作方法，例如 actionCreate(), actionView(), actionUpdate(), actionDelete(), actionIndex()。

6. 清除缓存

在修改了配置文件或代码后，建议清除 Yii2 的缓存。可以使用以下命令：

./yii cache/flush-all

或者删除 runtime/cache 目录下的所有文件。

7. 检查 Web 服务器配置

如果以上步骤都已检查，但仍然出现 404 错误，则可能是 Web 服务器配置问题。确保 Web 服务器已正确配置，可以将请求转发到 Yii2 的入口文件（通常是 web/index.php）。

总结

当 Yii2 Gii 生成的 CRUD 功能无法通过 URL 访问时，首先要检查 urlManager 配置，然后确认控制器、模型和视图文件位于正确的位置。特别注意视图文件应该位于与控制器同名的 views 目录下。清除缓存并检查 Web 服务器配置也是必要的步骤。通过这些步骤，通常可以解决 404 错误。

以上就是Yii2 CRUD 生成后 URL 访问 404 错误排查与解决的详细内容，更多请关注php中文网其它相关文章！