Laravel Eloquent存储大十六进制数到PostgreSQL异常如何解决

存储失败是两个限制共同导致的：

• PostgreSQL的BIGINT是有符号64位整数，取值上限为9223372036854775807（对应十六进制7FFFFFFFFFFFFFFF），你要存的FFFFFFF0002D4004转十进制为18446744065119633412，已经超出有符号BIGINT的存储上限。
• PHP原生hexdec()函数在处理超过平台整型长度的十六进制值时，会自动将结果转为浮点数，出现精度丢失，进一步导致写入数据库时类型、数值不匹配。

注意：Laravel提供的unsignedBigInteger()方法在PostgreSQL驱动下不生效，PostgreSQL原生没有无符号BIGINT类型，加了unsigned修饰也不会扩大字段存储范围。

根据业务场景选一种即可：

方案1：存精确十进制数值（适合需要做数值计算、大小比较的场景） #

1. 调整数据库迁移字段，用支持超大精确整数的DECIMAL类型替代BIGINT：

// 无符号64位整数最大为20位十进制数，精度设20、小数位设0即可完整存储
$table->decimal('battery', 20, 0)->nullable()->default(null);

2. 替换转换逻辑，用BCMath扩展提供的任意精度转换函数替代原生hexdec()，避免精度丢失：

// 提前确认PHP已安装bcmath扩展
$model->battery = bchexdec($value);

方案2：存原始二进制（适合仅做等值查询、不需要数值运算的场景） #

1. 调整迁移字段为PostgreSQL原生二进制类型BYTEA：

$table->binary('battery')->nullable()->default(null);

2. 存储时直接将十六进制转为二进制字符串，不需要转十进制：

$model->battery = hex2bin($value);

这种方式存储空间最小，16位十六进制值仅占8字节；读取时如果需要还原为十六进制格式，调用bin2hex($model->battery)即可。

方案3：直接存十六进制字符串（适合追求开发效率、对存储空间不敏感的场景） #

1. 调整迁移字段为字符串类型，如果你的十六进制值固定为16位，用定长字符串效率更高：

$table->char('battery', 16)->nullable()->default(null);
// 长度不固定的话替换为$table->string('battery')

2. 存储时不需要做任何转换，直接写入原始值即可：

$model->battery = $value;

这种方式实现最简单，读取后不需要额外转换就能直接使用，缺点是做数值类计算/比较时需要手动做类型转换，存储空间是二进制方案的2倍。

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