Laravel 9创建API资源控制器时触发ArgumentCountError错误

原命令问题分析 #

你执行的命令php artisan make:controller Api/UserController --resource --api存在选项冲突，并非命令弃用。Laravel 9中，--api选项已专门用于生成适配API场景的资源控制器（仅包含index/show/store/update/destroy这5个无视图相关的方法），而--resource选项是用于生成完整Web场景的资源控制器（包含create/edit等视图方法）。同时使用这两个选项会导致命令内部逻辑冲突，触发Router::resource()参数不足的错误。

正确生成API资源控制器的方法 #

1. 使用正确的artisan命令 #

执行以下命令即可生成符合需求的API资源控制器：

php artisan make:controller Api/UserController --api

该命令会自动在app/Http/Controllers/Api目录下生成带API标准资源方法的控制器文件。

2. 手动创建控制器 #

若artisan命令出现异常，可手动创建文件：
在app/Http/Controllers/Api目录下新建UserController.php，写入以下内容：

<?php

namespace App\Http\Controllers\Api;

use App\Http\Controllers\Controller;
use Illuminate\Http\Request;

class UserController extends Controller
{
    /**
     * 列出所有资源
     */
    public function index()
    {
        // 编写业务逻辑
    }

    /**
     * 存储新资源
     */
    public function store(Request $request)
    {
        // 编写业务逻辑
    }

    /**
     * 显示指定资源
     */
    public function show(string $id)
    {
        // 编写业务逻辑
    }

    /**
     * 更新指定资源
     */
    public function update(Request $request, string $id)
    {
        // 编写业务逻辑
    }

    /**
     * 删除指定资源
     */
    public function destroy(string $id)
    {
        // 编写业务逻辑
    }
}

3. 关联模型快速生成 #

如果需要关联User模型生成带基础CRUD逻辑的控制器，可执行：

php artisan make:controller Api/UserController --api --model=User

该命令会自动生成关联模型的代码片段，简化开发流程。

内容的提问来源于stack exchange，提问作者Alojarf