Laravel 8控制器在HostGator生产服务器无法正常工作的问题

问题背景 #

本地运行正常的Laravel 8项目，部署到HostGator生产服务器后，/form POST路由出现404错误，welcome路由正常。提交表单后URL显示https://tourman.com/form#contact，本地正常提交后会跳转到http://localhost/#contact。

相关代码 #

路由文件（web.php）

use Illuminate\Support\Facades\Route;

Route::get('/', function () {
    return view('welcome');
});

Route::post('form','App\Http\Controllers\UserController@store');

Route::get('/user/verify/{token}', 'App\Http\Controllers\UserController@verifyUser');

表单代码

<section class="contact" id="contact">
<div class="content">
@include('partials.alerts')
    <h1 class="heading">Contact Us</h1>
<form method="post" action="{{url('form')}}#contact">
            {{csrf_field()}}
            <div class="form">
  <div class="input-flex">
    <input type="text" name="name" placeholder="Name*" /><br><br>
    <span style="color:red">@error('name'){{$message}}@enderror</span>
    <input type="email" name="email" placeholder="E-mail*" /><br><br>
    <span style="color:red">@error('email'){{$message}}@enderror</span>
    <input type="tel" class="full-width" name="telephone" placeholder="Phone number*" /><br><br>
    <span style="color:red">@error('telephone'){{$message}}@enderror</span>
    <textarea cols="2" rows="2" class="full-width" name="message" placeholder="Message"></textarea>
   </div>
  <button  class="conbtn" type="submit">Submit</button>
</form>
</div>
</section>

控制器store方法

protected function store(Request $request)
{
    //validate request
    $this->validate($request,[
        'name' => 'required|max:100',
        'email' => 'required|email',
        'telephone' => 'required',
    ]);

    $user = new User;

    $user->name = $request->input('name');
    $user->email = $request->input('email');
    $user->telephone = $request->input('telephone');
    $user->message = $request->input('message');
    
    $user->save();

    $verifyUser = VerifyUser::create([
        'user_id' => $user->id,
        'token' => Str::random(40)
    ]);

    Mail::to($user->email)->send(new VerifyMail($user));
return redirect('/#contact')->with('info', 'We sent you an activation code. Check your email and click on the link to verify');
}

解决方案 #

1. 配置URL重写规则 #

HostGator默认可能未正确配置Laravel所需的URL重写，导致POST请求无法被框架处理：

• 确保项目根目录存在.htaccess文件，内容如下：

<IfModule mod_rewrite.c>
    <IfModule mod_negotiation.c>
        Options -MultiViews -Indexes
    </IfModule>

    RewriteEngine On

    # Handle Authorization Header
    RewriteCond %{HTTP:Authorization} .
    RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]

    # Redirect Trailing Slashes If Not A Folder...
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_URI} (.+)/$
    RewriteRule ^ %1 [L,R=301]

    # Send Requests To Front Controller...
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^ index.php [L]
</IfModule>

• 若文件不存在，直接创建并添加上述内容；若已存在，替换为正确配置。
• 确认服务器开启mod_rewrite模块，可联系HostGator客服确认，或通过phpinfo页面查看。

2. 修正表单action的锚点位置 #

表单action中的#contact锚点会干扰生产服务器的路由解析，将其移除：

<form method="post" action="{{url('form')}}">

控制器的redirect已经包含/#contact，提交后会自动跳转到对应锚点位置，无需在form action中添加。

3. 清理生产环境缓存并检查配置 #

• 确认.env文件中APP_URL设置正确：APP_URL=https://tourman.com
• 通过SSH登录服务器，执行缓存清理命令：

php artisan route:clear
php artisan config:clear

若无SSH权限，可联系HostGator协助执行，或创建临时PHP脚本完成缓存清理。

4. 验证控制器文件路径与命名 #

Linux服务器区分大小写，检查生产环境中UserController.php的路径为app/Http/Controllers/UserController.php，类名与文件名一致，且命名空间为namespace App\Http\Controllers;。

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