ThinkPHP 8 中 mixed 类型天然包含 null，无需加 ?，若函数可能返回 null 则声明 mixed 即可；若绝不应返回 null，应改用精确类型如 int 并抛异常；严禁使用 ?mixed，否则触发解析错误。
ThinkPHP 8 在 PHP 8.0+ 环境中使用 mixed 作为返回类型时，若函数逻辑可能返回 null，而声明又未显式允许可空，就会触发 Fatal error: Uncaught TypeError——这不是警告，是进程立即终止。
确认 mixed 类型是否被误用为可空类型
第一步：在项目中全局搜索 function.*?:\s*mixed 或 public function.*?:\s*mixed（可用 VS Code 正则搜索），重点检查自定义服务类、Facade 扩展、中间件 handle 方法、模型访问器（getAttr/setAttr）的返回声明。
第二步：对每个匹配函数，人工确认其实际执行路径是否可能返回 null。例如：public function getConfig(): mixed { return $this->cache->get('config'); } —— 若缓存未命中，$this->cache->get() 在 ThinkPHP 8 默认行为下返回 null，此时 mixed 声明合法；但若该方法内部有 return null; 显式分支，而你忘了加 ?mixed，就埋下致命隐患。
第三步：注意 mixed 已天然包含 null，所以 ?mixed 是非法语法，PHP 解析器会直接报错。只要函数确实可能返回 null，就只需写 mixed，无需加问号。
立即学习“PHP免费学习笔记（深入）”；
替换所有非法的 ?mixed 声明
方法一：直接删除问号
把 function getData(): ?mixed 改为 function getData(): mixed。这是唯一合规写法，因为 mixed 语义本身就覆盖了 null、string、array 等全部类型。
方法二：若逻辑上绝不应返回 null，改用更精确类型
比如原写 function getUserId(): ?mixed，但业务上用户 ID 永远是整数或抛异常，那就应改为 function getUserId(): int，并在无用户时 throw new InvalidArgumentException()。这比用 mixed 更安全，IDE 和 PHPStan 都能校验。
【严禁】在 mixed 前加 ?，否则 php -l 会直接报 Parse error
修复混合类型中隐含的 null 路径
第一步：定位到返回 mixed 的函数中所有 return 语句
逐行检查是否遗漏了 null 分支，尤其注意早期兼容写法如 return $result ?: null; 或 return $this->find() ?: null;。
第二步：若存在明确的 null 返回，且该函数已声明 mixed，则无需改动——这是合法且推荐的。
第三步：若发现某处 return false; 或 return '';，而调用方代码用 if (!$data) 判断，要立刻重构：
ThinkPHP 8 中，false 和空字符串 '' 不属于 mixed 的典型契约场景，容易误导后续维护者；应统一转为 null（表示“无值”）或抛出异常（表示“异常状态”）。
第四步：对返回 mixed 的模型访问器（如 getExtraAttr），确保数据库字段默认值设为 NULL 而非空字符串，避免 ORM 自动填充后类型失真。
