Yii2：访问多单词模型ServicioPeluquero的index页面出现404错误

开发者阿泽

2026-5-29

解决Yii2中双单词模型对应页面无法访问的问题

首先，针对你的ServicioPeluquero模型对应的页面访问问题，Yii2的路由规则严格遵循命名规范，正确的访问URL应该是：

localhost/yii2basic/web/index.php?r=servicio-peluquero

如果要明确指定默认的index动作，也可以写成：

localhost/yii2basic/web/index.php?r=servicio-peluquero/index

为什么之前的URL无法生效？

Yii2中控制器的路由ID是基于类名转换的，核心规则如下：

控制器类名必须是ServicioPeluqueroController（后缀固定为Controller），文件需放在controllers/ServicioPeluqueroController.php路径下
路由ID需要把控制器类名去掉Controller后缀后，将驼峰命名转换为短横线分隔的全小写格式——也就是ServicioPeluquero → servicio-peluquero

额外排查步骤

如果使用正确URL仍无法访问，建议检查以下几点：

确认controllers/ServicioPeluqueroController.php文件存在，且类名、文件名拼写完全一致（Yii2对大小写敏感，尤其是Linux环境下）

控制器中必须包含actionIndex方法，示例代码如下：

public function actionIndex()
{
    // 示例逻辑：查询模型数据并渲染视图
    $models = ServicioPeluquero::find()->all();
    return $this->render('index', [
        'models' => $models,
    ]);
}