Laravel跨Windows/Linux环境UUID格式不一致问题求助

Windows和Linux环境下，PHP连接SQL Server的驱动（如sqlsrv或pdo_sqlsrv）对uniqueidentifier类型字段的默认解析行为存在差异：

• Windows端驱动默认将UUID转换为可读的字符串格式
• Linux端驱动默认返回UUID的原始二进制字节流，也就是你看到的b"\x1A\x12î¥\x10\x1FüF·yIÒ ú;h"这类输出

方案1：模型层统一字段读取格式（推荐） #

在对应Laravel模型中为UUID字段定义访问器，强制将二进制数据转换为标准UUID字符串：

// 替换YourUuid为实际字段名
public function getYourUuidAttribute($value)
{
    // 判断是否为二进制UUID（长度16字节），是则转换为字符串格式
    if (is_string($value) && strlen($value) === 16) {
        return vsprintf('%s%s-%s-%s-%s-%s%s%s', str_split(bin2hex($value), 4));
    }
    return $value;
}

也可以用Laravel自带工具简化：

use Illuminate\Support\Str;

public function getYourUuidAttribute($value)
{
    if (is_string($value) && strlen($value) === 16) {
        return Str::uuidFromBytes($value)->toString();
    }
    return $value;
}

方案2：全局修改驱动配置 #

修改数据库连接配置（config/database.php），强制驱动返回字符串格式的UUID：

• 若使用pdo_sqlsrv驱动：

'options' => [
    PDO::SQLSRV_ATTR_FETCHES_UNIQUEIDENTIFIER_AS_STRING => true,
],

• 若使用sqlsrv驱动：

'options' => [
    'ReturnUniqueIdentifiersAsStrings' => true,
],

该方案会让所有uniqueidentifier字段都以字符串格式返回，全局生效。

方案3：写入时统一格式 #

确保写入数据库时，始终传入标准UUID字符串，避免二进制写入的差异：

use Illuminate\Support\Str;

// 生成标准字符串格式UUID
$uuid = Str::uuid()->toString();
// 若已有二进制UUID，先转换为字符串再写入
$uuid = Str::uuidFromBytes($binaryData)->toString();

在Linux环境下测试读取UUID字段，确认输出为A5EE121A-1F10-46FC-B779-49D2A0FA3B68这类标准格式，同时Windows环境保持原有正常输出即可。

内容的提问来源于stack exchange，提问作者C. MARTIN