Laravel中jQuery Ajax调用返回HTML而非JSON的问题排查

看起来你遇到的核心问题是：同一个逻辑放在路由闭包里能正常返回JSON，但放到SitesController的方法里就返回HTML，进而触发JSON解析错误。我来帮你一步步排查和解决这个问题：

首先定位问题根源：返回的HTML到底是什么？ #

先修改前端的AJAX错误回调，打印出返回的HTML内容，这能帮你快速定位问题：

$(".autocomplete").autocomplete({
 source: function(request, response) {
 $.ajax({
 url: '/autocomplete',
 dataType: "json",
 data: { term : request.term, field : $(this.element).prop("id") },
 success: function(data) {
 console.log(data);
 response(data);
 },
 error: function(result, status, error) {
 console.log("返回的HTML内容：");
 console.log(result.responseText); // 新增这行，查看具体返回的HTML
 console.log(status);
 console.log(error);
 }
 });
 },
 minLength: 0, // 注意这里要修正为驼峰式，jQuery UI的选项是minLength不是min_length
});

运行后看控制台，你大概率会看到以下两种情况之一：登录页面的HTML（未通过auth中间件），或者404页面的HTML（控制器路由配置错误）。

针对常见原因的解决方案 #

1. 控制器被添加了会重定向的中间件 #

如果你的SitesController构造方法里加了auth中间件，未登录时会自动跳转到登录页面，返回登录HTML：

// SitesController里的代码
public function __construct()
{
    $this->middleware('auth'); // 这行是罪魁祸首
}

解决方法：给autocomplete方法排除该中间件：

public function __construct()
{
    $this->middleware('auth')->except('autocomplete');
}

2. Laravel版本8+的路由命名空间问题 #

Laravel 8及以上版本默认取消了路由的默认控制器命名空间，如果你还是用旧写法：

// web.php里的错误写法
Route::get('/autocomplete', 'SitesController@autocomplete');

Laravel会找不到控制器，返回404页面的HTML。

解决方法：

• 方法一：使用完整命名空间+数组写法：

use App\Http\Controllers\SitesController;

Route::get('/autocomplete', [SitesController::class, 'autocomplete']);

• 方法二：在app/Providers/RouteServiceProvider.php里恢复默认命名空间：

protected $namespace = 'App\\Http\\Controllers'; // 取消这行的注释

3. 控制器类的基础配置问题 #

确保你的SitesController满足以下要求：

• 正确继承Laravel的基础控制器类
• 引入了必要的模型和请求类

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\Models\Site; // 确保Site模型的命名空间正确

class SitesController extends Controller
{
    public function autocomplete(Request $request) {
        $term = $request->get('term');
        $field = $request->get('field');
        
        // 可以用pluck简化foreach逻辑
        $data = Site::where($field, 'ILIKE', '%'.$term.'%')
            ->distinct()
            ->pluck($field)
            ->toArray();
            
        return response()->json($data); // 用response()->json()更规范
    }
}

4. 额外排查：请求是否真的到达控制器 #

在控制器方法开头添加日志，确认请求是否被正确接收：

public function autocomplete(Request $request) {
    \Log::info('Autocomplete请求参数：', $request->all()); // 记录请求参数
    // ... 其余代码
}

然后查看storage/logs/laravel.log，如果没有这条日志，说明请求根本没到达控制器，回到路由和中间件排查。

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