Laravel中使用->withInput()与->with()返回视图失败求助

问题根源 #

1. withInput() 方法使用场景错误：该方法专为redirect()重定向设计，用于将用户输入存入session供下一次请求读取。直接在return view()的链式调用中调用会触发"Undefined array key 0"错误。
2. ->with() 传递消息的逻辑偏差：在return view()后使用->with()，传递的是普通视图变量，并非闪存消息（闪存消息仅在当前请求的下一次请求中有效，刷新页面后自动消失）。如果需要实现闪存效果，必须结合session或重定向的with()方法。

修复方案 #

方案一：直接返回视图（适配GET请求场景） #

若需保持直接返回视图的逻辑，需手动传递旧输入和消息：

class ArticlesSearchHelpCenterController extends Controller
{
    public function index(Request $request)
    {
        $validated = Validator::make($request->all(), [
            'search_query' => ['required', 'min:3']
        ]);

        $categories = HelpCenterCategory::all();
        $searchTerm = $request->input('search_query'); // 用input()避免未定义索引错误

        if ($validated->fails()) {
            $articles = HelpCenter::latest()->paginate(24);

            // 手动传递旧输入和错误消息到视图
            return view('siteadmin.help.help', [
                'articles' => $articles,
                'categories' => $categories,
                'search_query' => $searchTerm,
                'error' => '搜索出现问题，请检查输入。'
            ]);
        }

        // 验证通过的搜索逻辑
        $articles = HelpCenter::where('headline', 'LIKE', "%{$searchTerm}%")
            ->latest()
            ->paginate(2)
            ->appends($request->all()); // 链式调用appends，无需单独赋值

        // 手动传递旧输入和成功消息
        return view('siteadmin.help.help', [
            'articles' => $articles,
            'categories' => $categories,
            'search_query' => $searchTerm,
            'success' => "找到 xx 条结果。"
        ]);
    }
}

视图中直接调用变量：

<!-- 显示错误消息 -->
@if(isset($error))
    <div class="alert alert-danger">{{ $error }}</div>
@endif

<!-- 显示成功消息 -->
@if(isset($success))
    <div class="alert alert-success">{{ $success }}</div>
@endif

<!-- 回显旧输入 -->
<input type="text" name="search_query" value="{{ old('search_query', $search_query) }}">

方案二：使用重定向（推荐，遵循PRG模式） #

采用Post/Redirect/Get模式，避免页面刷新重复提交请求，同时原生支持闪存消息和旧输入：

1. 配置路由：

// routes/web.php
Route::get('help-center', [ArticlesSearchHelpCenterController::class, 'showList'])->name('help-center.list');
Route::post('help-center/search', [ArticlesSearchHelpCenterController::class, 'handleSearch'])->name('help-center.search');

2. 修改控制器逻辑：

class ArticlesSearchHelpCenterController extends Controller
{
    // 显示初始列表页
    public function showList(Request $request)
    {
        $categories = HelpCenterCategory::all();
        $searchTerm = $request->input('search_query');
        
        // 根据搜索参数加载对应内容
        $articles = $searchTerm 
            ? HelpCenter::where('headline', 'LIKE', "%{$searchTerm}%")
                ->latest()
                ->paginate(2)
                ->appends($request->all())
            : HelpCenter::latest()->paginate(24);

        return view('siteadmin.help.help', [
            'articles' => $articles,
            'categories' => $categories
        ]);
    }

    // 处理搜索提交（POST请求）
    public function handleSearch(Request $request)
    {
        $validated = Validator::make($request->all(), [
            'search_query' => ['required', 'min:3']
        ]);

        if ($validated->fails()) {
            // 重定向回列表页，携带验证错误和旧输入
            return redirect()->route('help-center.list')
                ->withErrors($validated)
                ->withInput();
        }

        // 验证通过，重定向回列表页并携带搜索参数和成功消息
        return redirect()->route('help-center.list', [
            'search_query' => $request->input('search_query')
        ])->with('success', "找到 xx 条结果。");
    }
}

3. 视图中使用session辅助方法读取闪存内容：

<!-- 显示验证错误 -->
@if($errors->any())
    <div class="alert alert-danger">
        @foreach($errors->all() as $error)
            <p>{{ $error }}</p>
        @endforeach
    </div>
@endif

<!-- 显示成功闪存消息 -->
@if(session('success'))
    <div class="alert alert-success">{{ session('success') }}</div>
@endif

<!-- 回显旧输入 -->
<input type="text" name="search_query" value="{{ old('search_query', request('search_query')) }}">

关键说明 #

• withInput() 仅在redirect()后使用有效，因为它依赖session存储输入内容供下一次请求读取。
• 重定向时的->with('key', 'value')会自动将消息存入session，仅在下次请求中有效，符合搜索场景的用户体验。
• 使用withErrors()可直接传递验证器的错误信息，无需手动拼接错误文本。

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