根本原因是自动加载未生效，需确保入口文件引入 vendor/autoload.php 且路径正确；PHP 7.4 以下不支持 uuid7；存 UUID 应匹配 toString() 与 VARCHAR(36) 或 getHex() 与 CHAR(32)；uuid6 并发重复需复用 UuidFactory 并保障 NTP 时钟同步。
composer require ramsey/uuid 后 Uuid::uuid4() 报错 Class not found
根本原因是自动加载没生效，不是库没装上。执行 composer require ramsey/uuid 后，如果项目没用过 Composer 自动加载（比如没引入过 vendor/autoload.php），类就根本不会被识别。
- 确认入口文件（如
index.php）开头已包含：require 'vendor/autoload.php'; - 检查
vendor/autoload.php文件真实存在，且路径正确（不能写成./vendor/autoload.php却在子目录运行） - 如果用的是 PSR-4 自定义命名空间，别把
Ramsey\Uuid\Uuid错当成你自己的类去 autoload —— 它只走 Composer 的 vendor 加载链
PHP 7.4 以下版本调用 Uuid::uuid7() 直接失败
Uuid::uuid7() 是 Ramsey UUID 4.7+ 新增的，依赖 PHP 的 hrtime() 和 RFC 9562 时间戳规范，PHP 7.3 及更早不支持 hrtime() 的纳秒精度，所以会抛出 BadMethodCallException 或静默返回 null。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 生产环境 PHP 版本低于 7.4？直接放弃
uuid7，改用Uuid::uuid4()或Uuid::uuid6()（后者需 7.2+） - 想验证当前环境是否支持：运行
var_dump(function_exists('hrtime'));，返回false就别碰uuid7 - 注意：Laravel 9+ 默认要求 PHP 8.0+，但如果你是裸 PHP 项目，得自己盯版本兼容表
生成的 UUID 字符串带大写字母，数据库存不进去
默认 Uuid::uuid4()->toString() 返回的是标准格式（含小写 a–f），但某些旧版驱动或自定义序列化逻辑可能误转大写；更常见的是你用了 Uuid::uuid4()->getHex()，它返回纯 32 位十六进制字符串（无连字符），而你字段类型设成了 CHAR(36) 却塞了 32 个字符，触发截断或报错。
- 存标准格式（36 字符）：用
->toString()，字段类型设为VARCHAR(36)或CHAR(36) - 存紧凑格式（32 字符）：用
->getHex()，字段必须是CHAR(32)，且确保所有读写逻辑统一 - MySQL 中避免大小写问题：字段用
COLLATE utf8mb4_bin或直接用二进制类型BINARY(16)存->getBytes()结果，更省空间也更准
并发环境下 Uuid::uuid6() 时间戳部分重复
uuid6 基于时间 + 随机序列生成，理论上每毫秒最多支持 10k+ 个唯一值，但实际中若系统时钟回拨、虚拟机休眠、或高并发下多个进程/线程在同一毫秒内初始化 Uuid 对象，序列号计数器可能未及时更新，导致前缀时间戳相同、后缀又撞随机数。
- 别在单次请求里循环调用
Uuid::uuid6()几百次——改用UuidFactory实例复用，它内部维护序列号状态 - 示例：
$factory = new \Ramsey\Uuid\UuidFactory(); $uuid = $factory->uuid6(); - 容器化部署时，确保宿主机 NTP 同步稳定；K8s 环境建议加
hostTime: true避免容器时钟漂移
UuidFactory 的复用和时钟同步这两件事——前者影响唯一性，后者影响可排序性，光看文档示例很容易跳过去。 
