Shopware 6后台报错：‘The String is not a valid UUID’求助

问题原因 #

你用Utils.createId()生成的是无连字符的32位十六进制字符串（比如018A41183FDB7460896E02F5F3EE7D8E），但Shopware 6的实体ID字段要求的是带连字符的标准UUID格式（例如018a4118-3fdb-7460-896e-02f5f3ee7d8e），格式不匹配导致约束校验失败。

解决方案 #

方案1：使用Shopware官方标准UUID生成方法 #

直接使用Shopware核心提供的Uuid工具类生成符合要求的UUID：

// 引入类
use Shopware\Core\Framework\Uuid\Uuid;

// 生成带连字符的十六进制UUID
$validUuid = Uuid::createHex();
// 若需存储二进制格式ID
$binaryUuid = Uuid::createBytes();

该方法生成的ID自动符合Shopware的字段约束规则。

方案2：手动转换现有ID格式 #

如果必须使用Utils.createId()的结果，手动为字符串插入连字符，转换成标准UUID格式：

// 前端场景下转换示例
const rawId = Utils.createId();
const validUuid = rawId.replace(/^(.{8})(.{4})(.{4})(.{4})(.{12})$/, '$1-$2-$3-$4-$5');

转换后的ID即可通过Shopware的格式校验。

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