Laravel本地可更新会员，服务器端无法更新问题求助

问题描述 #

我正在开发一个API，多数功能运行正常，但会员更新功能出现异常：本地环境发送PUT请求可正常更新会员并返回更新后的数据，但部署到服务器后，请求返回的仍是原会员数据，数据库也未更新。认证功能正常，获取token后发送请求，本地有效服务器无效。已尝试两台不同服务器，该项目是带Web端和API的成品Laravel应用，扩展API时其他功能正常，仅更新方法异常。

路由配置 #

Route::prefix('member')->group(function () {
    Route::post('login', [App\Http\Controllers\Api\MemberAuthController::class, 'login']);
    Route::post('register', [App\Http\Controllers\Api\MemberAuthController::class, 'register']);

    Route::middleware('auth:member_api', 'member.auth.api')->group(function () {
        Route::get('/', [App\Http\Controllers\Api\MemberAuthController::class, 'getMember']);
        Route::put('/', [App\Http\Controllers\Api\MemberController::class, 'update']);
    });
});

MemberController 的 update 方法 #

/**
 * @param string $locale The locale setting (e.g., 'en-us')
 * @param Request $request
 * @param MemberService $memberService
 * @return \Illuminate\Http\JsonResponse
 */
public function update(string $locale, Request $request, MemberService $memberService)
{
    $member = $request->user('member_api');

    $data = $request->only(['name', 'email', 'password', 'street_name_number', 'city', 'zipcode', 'phone']);

    $updatedMember = $memberService->update($member, $data);

    return response()->json(['member' => $updatedMember], 200);
}

MemberService 的 update 方法 #

/**
 * @param Member $member
 * @param array $data
 * @return Member
 */
public function update(Member $member, array $data): Member
{
    if (isset($data['password'])) {
        $data['password'] = bcrypt($data['password']);
    }

    $member->update($data);

    return $member->fresh();
}

Member 模型相关代码 #

class Member extends Authenticatable implements HasLocalePreference, HasMedia
{
    use HasApiTokens, Notifiable, InteractsWithMedia, HasIdentifier, HasCustomShortflakePrimary, HasSchemaAccessors;

    /**
     * The table associated with the model.
     *
     * @var string
     */
    protected $table = 'members';

    /**
     * The attributes that should be cast.
     *
     * @var array<string, string>
     */
    protected $casts = [
        'email_verified_at' => 'datetime',
        'last_login_at' => 'datetime',
        'meta' => 'array',
        'created_at' => 'datetime',
        'created_at' => 'datetime',
        'deleted_at' => 'datetime',
    ];

    /**
     * The attributes that should not be exposed by API and other public responses.
     *
     * @var array
     */
    protected $hiddenForPublic = [
        'affiliate_id',
        'role',
        'member_number',
        'display_name',
        'birthday',
        'gender',
        'two_factor_enabled',
        'two_factor_secret',
        'two_factor_recovery_codes',
        'account_expires_at',
        'premium_expires_at',
        'country_code',
        'phone_prefix',
        'phone_country',
        'phone',
        'phone_e164',
        'is_vip',
        'is_active',
        'accepts_text_messages',
        'is_undeletable',
        'is_uneditable',
        'number_of_emails_received',
        'number_of_text_messages_received',
        'number_of_reviews_written',
        'number_of_ratings_given',
        'meta',
        'media',
        'deleted_at',
        'deleted_by',
        'created_by',
        'updated_by'
    ];

    public function hideForPublic() 
    {
        $this->makeHidden($this->hiddenForPublic);

        return $this;
    }

    /**
     * Allow mass assignment of a model.
     *
     * @var array
     */
    protected $guarded = [];

    /**
     * Append programmatically added columns.
     *
     * @var array
     */
    protected $appends = [
        'avatar',
    ];

    /**
     * The attributes that should be hidden for serialization.
     *
     * @var array<int, string>
     */
    protected $hidden = [
        'password',
        'remember_token',
    ];

    public function newEloquentBuilder($query)
    {
        return new MemberQueryBuilder($query);
    }
}

排查方向 #

• 请求数据接收校验：在控制器中添加日志记录\Log::info($request->all());，对比本地和服务器的请求数据是否一致，同时确认请求头的Content-Type是否为application/json。
• 自定义查询构建器限制：检查MemberQueryBuilder是否在服务器环境中对更新操作添加了额外条件，比如is_uneditable = true的限制，同时核对服务器会员数据的is_uneditable字段值。
• 数据库配置问题：确认服务器数据库是否存在读写分离配置错误（更新请求发到只读库），或者是否有未提交的事务导致更新未生效。
• 缓存影响：执行服务器端缓存清除命令php artisan cache:clear，排查是否因模型缓存或应用缓存导致返回旧数据。
• 中间件拦截：临时移除member.auth.api中间件测试更新功能，确认该中间件是否在服务器环境中做了额外校验拦截。
• 数据验证异常：添加请求验证逻辑，捕获可能存在的验证错误（如邮箱格式、密码长度不符合要求），排查是否因未处理的验证失败导致更新终止。
• 模型事件拦截：检查Member模型是否注册了updating/updated事件监听，确认回调中是否存在阻止更新的逻辑（如返回false）。

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