Laravel路由缺失school_student参数问题排查求助

遇到如下错误：

Missing required parameter for [Route: history_form.createHistory] [URI: history_forms/createH/{school_student}] [Missing parameter: school_student].

已在路由、控制器及创建按钮中配置school_student参数，但调用create方法时student_id仍返回null，以下是排查方案及解决办法：

相关代码 #

路由代码 #

Route::get('/history_forms/createH/{school_student}', 'HistoryFormController@create')->name('history_form.createHistory');

控制器create方法 #

public function create(Request $request, School_student $school_student){        
        $page_title = "Dados específicos de Histórico Escolar";

        $school_Student = History_form::notesn($school_student->id);
    
        $history_forms = new History_form();
        $history_notes = new History_form_notes();

        $data['breadcrumbs'][0]['nome'] = 'Histórico Escolar';
        $data['breadcrumbs'][0]['link'] = 'index'; 

        $data['breadcrumbs'][1]['nome'] = 'Preencher Histórico Escolar';
        $data['breadcrumbs'][1]['link'] = 'createHistory';

        $data['route']              = 'history_form';
        $data['return']             = 'school_student';
        $data['lang']               = App::getLocale();
        $data['buttons']['cancel']  = true;
        $data['buttons']['save']    = true;

        $data['id'] = $school_student->id;

        $data['fields'][0]['id']            = 'school_student_id';
        $data['fields'][0]['description']   = 'Aluno(a)';
        $data['fields'][0]['placeholder']   = 'Aluno(a)';
        $data['fields'][0]['type']          = 'select';
        $data['fields'][0]['icon']          = 'fas fa-square';
        $data['fields'][0]['data']          =  $history_forms->id;

        $data['fields'][0]['select']['data']     = School_student::getStudent($school_student->id);
        $data['fields'][0]['select']['field'][0] = 'id';
        $data['fields'][0]['select']['field'][1] = 'name';

        $data['fields'][1]['id']            = 'stage';
        $data['fields'][1]['description']   = 'Etapa';
        $data['fields'][1]['placeholder']   = 'Selecione a etapa';
        $data['fields'][1]['type']          = 'select';
        $data['fields'][1]['icon']          = 'fas fa-square';
        $data['fields'][1]['data']          =  $history_forms->stage_id;

        $data['fields'][1]['select']['data']     = Classification_table::listGroup(2);
        $data['fields'][1]['select']['field'][0] = 'id';
        $data['fields'][1]['select']['field'][1] = 'name';

        $data['fields'][2]['id']            = 'teaching_unit';
        $data['fields'][2]['description']   = 'Unidade de ensino';
        $data['fields'][2]['placeholder']   = 'Unidade de ensino';
        $data['fields'][2]['type']          = 'text';
        $data['fields'][2]['icon']          = 'fas fa-book-reader';
        $data['fields'][2]['data']          = $history_forms->teaching_unit;

        $data['fields'][3]['id']            = 'uf_school';
        $data['fields'][3]['description']   = 'UF da Unidade de ensino';
        $data['fields'][3]['placeholder']   = 'UF da Unidade de ensino';
        $data['fields'][3]['type']          = 'text';
        $data['fields'][3]['icon']          = 'fas fa-book-reader';
        $data['fields'][3]['data']          = $history_forms->uf_school;

        $data['fields'][4]['id']            = 'year';
        $data['fields'][4]['description']   = 'Ano letivo anterior';
        $data['fields'][4]['placeholder']   = 'Ano letivo anterior';
        $data['fields'][4]['type']          = 'text';
        $data['fields'][4]['icon']          = 'fas fa-book-reader';
        $data['fields'][4]['data']          = $history_forms->year;

        $data['fields'][5]['id']            = 'city';
        $data['fields'][5]['description']   = 'Cidade';
        $data['fields'][5]['placeholder']   = 'Cidade';
        $data['fields'][5]['type']          = 'text';
        $data['fields'][5]['icon']          = 'fas fa-book-reader';
        $data['fields'][5]['data']          = $history_forms->city;

        $data['fields'][6]['id']            = 'uf_city';
        $data['fields'][6]['description']   = 'UF da cidade';
        $data['fields'][6]['placeholder']   = 'UF da cidade';
        $data['fields'][6]['type']          = 'text';
        $data['fields'][6]['icon']          = 'fas fa-book-reader';
        $data['fields'][6]['data']          = $history_forms->uf_city;

        $data['fields'][7]['id']            = 'workload_offered';
        $data['fields'][7]['description']   = 'Carga horária ofertada';
        $data['fields'][7]['placeholder']   = 'Carga horária ofertada';
        $data['fields'][7]['type']          = 'text';
        $data['fields'][7]['icon']          = 'fas fa-book-reader';
        $data['fields'][7]['data']          = $history_forms->workload_offered;

        $data['fields'][8]['id']            = 'frequency';
        $data['fields'][8]['description']   = 'Frequência';
        $data['fields'][8]['placeholder']   = 'Frequência';
        $data['fields'][8]['type']          = 'text';
        $data['fields'][8]['icon']          = 'fas fa-book-reader';
        $data['fields'][8]['data']          = $history_forms->frequency;

        $data['fields'][9]['id']            = 'situation';
        $data['fields'][9]['description']   = 'Situação';
        $data['fields'][9]['placeholder']   = 'Situação';
        $data['fields'][9]['type']          = 'text';
        $data['fields'][9]['icon']          = 'fas fa-book-reader';
        $data['fields'][9]['data']          = $history_forms->frequency;

        $data['fields'][10]['id']            = 'disciplines';
        $data['fields'][10]['description']   = 'Disciplina';
        $data['fields'][10]['placeholder']   = 'Disciplina';
        $data['fields'][10]['type']          = 'text';
        $data['fields'][10]['icon']          = 'fas fa-book-reader';
        $data['fields'][10]['data']          = $history_notes->disciplines;

        $data['fields'][11]['id']            = 'notes';
        $data['fields'][11]['description']   = 'Nota';
        $data['fields'][11]['placeholder']   = 'Nota';
        $data['fields'][11]['type']          = 'text';
        $data['fields'][11]['icon']          = 'fas fa-book-reader';
        $data['fields'][11]['data']          = $history_notes->notes;

        $data['data'] = $school_student;

        return view('form.create_history', compact('data', 'page_title'));
    }

创建按钮代码 #

@if ($data['buttons']['create'])
    <button title="{{ __('Inserir') }}" type="button" class="btn bg-gradient-primary float-right" onclick="window.location.href = '{{ route($data['route'].'createHistory',['school_student'=>$school_student->id]) }}'">
        <i class="fas fa-plus"></i> &nbsp;{{ __('Criar') }}
    </button>
@endif

排查与解决办法 #

1. 修复按钮路由名称拼接错误 #

按钮中route($data['route'].'createHistory')会拼接成history_formcreateHistory，缺少路由名称的分隔符.，这是参数缺失的核心原因。正确写法：

route($data['route'] . '.createHistory', ['school_student' => $school_student->id])

2. 验证视图中$school_student变量是否存在 #

按钮代码用到$school_student->id，如果当前视图没有传递该变量，会导致参数为null。可以在按钮上方临时添加{{ dd($school_student) }}验证变量是否存在，确保渲染视图时通过compact('school_student')或with('school_student', $school_student)传递了变量。

3. 检查路由模型绑定有效性 #

控制器使用了路由模型绑定School_student $school_student，需确认：

• School_student模型的主键是id，如果不是，在模型中定义protected $primaryKey = '你的主键名';
• 可以给路由添加参数规则，强制匹配数字ID：

  Route::get('/history_forms/createH/{school_student}', 'HistoryFormController@create')
      ->name('history_form.createHistory')
      ->where('school_student', '[0-9]+');
  

4. 手动测试路由参数 #

直接在浏览器访问/history_forms/createH/1（替换1为实际学生ID），如果控制器能正确获取$school_student，说明路由绑定正常，问题仍在按钮的路由生成逻辑。

5. 统一控制器变量名 #

控制器中定义了$school_student，后续又用了$school_Student（首字母大写），虽然不直接影响参数传递，但建议保持变量名一致，避免混淆。

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