常见问题

依赖问题

由于 Laravel11 刚发布，无法安装。可能是由于镜像更新慢导致的，所以建议取消使用镜像。使用'魔法'(懂得吧)去下载

使用腾讯云镜像

使用下面的命令即可

shell

composer config -g repos.packagist composer https://mirrors.tencent.com/composer/

使用华为云镜像（目前建议）

composer config -g repo.packagist composer https://repo.huaweicloud.com/repository/php/

设置了菜单，却只显示子级?

目前菜单设置上，如果是二级菜单，并且只有一个二级菜单的情况下，那么只会显示二级菜单。

路由未找到

遇到这个问题首先去查看路由

php artisan route:list

看看接口路由是否在路由表里，如果没有找到，那么就应该看看模块是否开启，在 storage/app/modules.json 文件里查看，以权限模块为例

json

{
  "title": "权限管理",
  "name": "permissions",
  "path": "permissions",
  "keywords": "权限, 角色, 部门",
  "description": "权限管理模块",
  "provider": "\\Modules\\Permissions\\Providers\\PermissionsServiceProvider",
  "version": "1.0.0",
  "enable": true // 该字段是否开启
}

模块路由命名重复

最近整 PRO 的时候遇到一个问题, CMS 模块和 SHOP 模块都有一个分类控制，名为 CategoryController, 正常来说只要这么分组设置路由就可以了

php

// cms 分类路由
Route::prefix('cms')->group(function () {
    Route::apiResource('category', CategoryController::class);
});

// shop 分类路由
Route::prefix('shop')->group(function () {
    Route::apiResource('category', CategoryController::class);
});

但是这里会出现一个问题，当使用

php artisan route:cache

的时候，会提示一个错误

shell

  Unable to prepare route [api/shop/category] for serialization. Another route has already been assigned name [category.index].

这个问题就是两个路由的 name 重复了, 无法进行缓存了。这里就需要设置成这样,只改 shop 的路由即可

php

// shop 分类路由
Route::prefix('shop')->group(function () {
    Route::apiResource('category', CategoryController::class)->names('shop_category')
});

常见问题 ​

依赖问题 ​

推荐镜像 ​

使用腾讯云镜像 ​

使用华为云镜像（目前建议） ​

设置了菜单，却只显示子级? ​

路由未找到 ​

模块路由命名重复 ​