Laravel API Resource未返回指定数据问题求助

核心排查方向 #

你的代码逻辑本身是正确的，但返回全量数据说明MerchantResource没有被正确解析，以下是几个最可能的原因及对应解决办法：

1. 检查sendApiResponse封装方法 #

控制器最终通过$this->sendApiResponse(new MerchantResource($user), ...)返回结果，如果这个自定义方法没有正确处理Laravel的Resource实例，而是直接将传入对象转为数组（比如调用$data->toArray()而非让Resource自行解析），就会导致返回全量模型数据。

解决办法：
打开定义sendApiResponse的基控制器或工具类，确保方法正确处理Resource实例：

protected function sendApiResponse($data, $message = '', $error = '', $extra = [])
{
    // 优先处理Resource实例
    if ($data instanceof \Illuminate\Http\Resources\Json\JsonResource) {
        $data = $data->resolve();
    }

    $response = [
        'data' => $data,
        'message' => $message,
        'error' => $error,
    ];

    if (!empty($extra)) {
        $response = array_merge($response, $extra);
    }

    return response()->json($response);
}

2. 确认MerchantResource的引入与类名 #

检查控制器顶部是否正确引入了目标Resource类，避免拼写错误或引入了错误的Resource（比如误引入UserResource）：

// 确保引入正确的Resource类
use App\Http\Resources\MerchantResource;

3. 检查模型的$visible/$hidden或toArray方法 #

如果User或Shop模型的$hidden属性被清空，或者新增了自定义toArray方法覆盖默认逻辑，会导致所有字段被返回。

解决办法：
检查User模型的字段隐藏配置：

class User extends Model
{
    // 保留需要隐藏的敏感字段
    protected $hidden = [
        'password',
        'otp',
        'email_verified_at',
        // 其他不需要返回的字段
    ];

    // 确认没有自定义toArray方法覆盖默认行为（除非业务明确需要）
}

4. 清除缓存 #

如果近期执行过缓存命令（如php artisan config:cache），可能导致Resource的修改未生效。

解决办法：
执行以下命令清除缓存：

php artisan cache:clear
php artisan config:clear
php artisan route:clear

5. 排查全局Resource绑定 #

如果项目在服务提供者中绑定了User模型到全局Resource，可能会覆盖当前MerchantResource的使用。

解决办法：
检查AppServiceProvider的boot方法，是否存在类似全局绑定代码：

// 若存在此类绑定，确认是否影响当前登录场景
User::resolveUsing(function ($user) {
    return new UserResource($user);
});

快速验证步骤 #

1. 跳过sendApiResponse，直接返回Resource测试：

// 替换原返回代码
return response()->json([
    'data' => new MerchantResource($user),
    'message' => 'Successfully logged in',
    'token' => $token
]);

如果此方式能返回指定字段，说明问题出在sendApiResponse方法上。

2. 给MerchantResource加日志验证是否被执行：

public function toArray($request): array
{
    \Log::info('MerchantResource toArray method executed'); // 临时添加日志
    return [
        // 原字段定义
    ];
}

如果日志未输出，说明Resource未被调用。

内容的提问来源于stack exchange，提问作者Masum Rahman Hasan