Laravel Cookie偶发设置失败、Set-Cookie头语法错误问题求助

故障原因排查 #

你遇到的时好时坏的问题主要由以下几个常见原因导致：

• Cookie大小超限：浏览器对单条Cookie的大小限制普遍为4KB（4096字节），当表单内容较多时，序列化后的JSON字符串超过该阈值会导致Set-Cookie头被截断，触发语法错误，刚好匹配你内容少时正常、内容多时失效的表现。
• 特殊字符未编码：JSON字符串中可能包含中文、空格、分号、逗号等Cookie规范中的保留字符，直接存入会导致Cookie头格式解析失败。
• Cookie有效期参数错误：Laravel的Cookie::make()方法第三个参数为有效期分钟数，你传入的是Unix时间戳格式的秒级数值，会导致Set-Cookie头的Expires属性值完全不符合规范，直接触发语法报错。
• 多余的Cookie删除操作：Cookie::forget()本质是返回一个过期的Set-Cookie头，和你后续新增Cookie的操作同时存在时，可能出现响应头顺序异常，导致新Cookie被过期规则覆盖。

解决方案 #

优先方案（推荐）

直接改用前端localStorage存储表单自动保存数据，无需走后端请求，单域存储上限为5~10MB，完全满足表单存储需求，也不存在Cookie的各种格式限制，仅在用户正式提交表单时再将数据上传至后端即可。

若必须使用Cookie存储的优化方案

按以下规则修改代码即可：

1. 对JSON序列化后的内容做URL编码处理特殊字符
2. 修正Cookie有效期参数为分钟单位
3. 移除多余的旧Cookie删除操作，同名新Cookie会自动覆盖旧值
4. 可根据需要添加长度判断，超过4KB时提示用户内容过多

修改后存储代码

public function autoSave() {
    $data = request()->validate([
        'data' => 'required'
    ]);
    // 有效期为1年，单位为分钟
    $lifetime = 365 * 24 * 60;
    // 序列化后URL编码处理特殊字符
    $encodedJson = urlencode(json_encode($data));
    // 直接创建同名Cookie覆盖旧值
    $cookie = Cookie::make('listData', $encodedJson, $lifetime);
    return response()->json(['success' => true])->withCookie($cookie);
}

修改后读取代码

public function getAutoSave() {
    $cookieData = Cookie::get('listData');
    if (!is_null($cookieData)) {
        // 先URL解码再解析JSON
        $data = json_decode(urldecode($cookieData));
        return response()->json([
            'data' => $data
        ]);
    }
    return response()->json([
        'data' => false
    ]);
}

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