Laravel中PostgreSQL BYTEA列压缩数据读写异常问题排查

核心问题：双重转义导致压缩数据损坏 #

你遇到的问题根源是手动调用pg_escape_bytea导致二进制数据被双重转义：

• 保存时：Laravel的binary字段（对应PostgreSQL的BYTEA类型）本身已经会自动处理二进制数据的数据库适配转义，你额外调用pg_escape_bytea，会把原始压缩二进制转换成PostgreSQL的BYTEA文本表示格式（比如将二进制\x00转义为字符串\\x00），最终存入数据库的是这个转义后的文本字符串，而非真正的压缩二进制数据。
• 读取时：Laravel返回的是转义后的文本字符串，你直接用gzinflate去解析它，自然不是有效的zlib压缩数据，因此触发data error错误。

另外，最初的UTF8编码错误，是因为压缩后的二进制包含非UTF-8兼容的字节，Laravel默认将其当作字符串处理时，编码校验失败导致的。

正确的自定义Cast实现 #

不需要手动调用pg_escape_bytea，直接利用Laravel的binary字段对二进制数据的原生支持即可，以下是正确的Compressed转换类示例：

<?php

namespace App\Casts;

use Illuminate\Contracts\Database\Eloquent\CastsAttributes;

class Compressed implements CastsAttributes
{
    /**
     * 从数据库读取字段时的处理
     */
    public function get($model, $key, $value, $attributes)
    {
        if (is_null($value)) {
            return null;
        }
        // 直接对原始二进制数据解压
        return gzinflate($value);
    }

    /**
     * 保存到数据库时的处理
     */
    public function set($model, $key, $value, $attributes)
    {
        if (is_null($value)) {
            return null;
        }
        // 生成原始压缩二进制，交给Laravel处理数据库适配
        return gzdeflate($value);
    }
}

补充说明 #

• 如果使用gzcompress（zlib完整格式），解压时要对应使用gzuncompress，避免格式不匹配导致错误。
• 确保模型中该字段的Cast配置正确，比如在模型的$casts数组中设置：'data' => Compressed::class。

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