已配置MySQL utf8mb4，Laravel Nova仍报UTF-8字符编码错误

DevOps 小满

2026-6-15

问题描述

我有一个基于Laravel v10.48.20开发的项目，使用Laravel Nova v4.34.3展示数据。近期添加含德语字符的记录后，Nova资源频繁抛出错误：

Malformed UTF-8 characters, possibly incorrectly encoded

项目初始已在config/database.php中配置：

'mysql' => [
    'driver'         => 'mysql',
    // ...其他设置...
    'charset'        => 'utf8mb4',
    'collation'      => 'utf8mb4_unicode_ci',
    // ...其他设置...
],

按此数据库设置，UTF-8字符不应引发该问题。我执行查询SELECT name FROM offers WHERE CHAR_LENGTH(name) != CHAR_LENGTH(CONVERT(name USING utf8mb4));检查表中编码错误值，未得到结果。PHP设置中default_charset = "UTF-8"。Nova字段配置为：

Text::make('Name')
    ->sortable()
    ->help('The name of the offer.'),

请问该问题可能由什么原因导致？

可能的原因及排查方向

字符串处理误用非多字节安全函数
如果在模型访问器、观察者或Nova资源的自定义逻辑中，对name字段执行了截断、替换、拼接等操作，但使用了substr、strlen这类非多字节安全的PHP函数，会破坏德语特殊字符（如ä、ö、ü）的UTF-8编码结构，触发错误。
排查：检查所有涉及name字段的自定义代码，替换为mb_substr、mb_strlen等多字节安全函数。
数据库连接实际编码与配置不符
虽然config/database.php中配置了utf8mb4，但可能存在配置缓存未更新、.env文件覆盖设置，或数据库服务端默认编码未同步的情况，导致实际连接使用了非UTF-8编码。
排查：在项目中执行DB::select('SHOW VARIABLES LIKE "character_set_connection"')查看实际连接编码，同时执行SHOW CREATE TABLE offers;确认表的实际字符集。
存在隐藏的无效UTF-8字符
你使用的CHAR_LENGTH查询无法检测所有无效UTF-8序列，部分数据可能包含截断的多字节字符或看似合法的无效字节，这些字符在Nova渲染时会触发编码错误。
排查：用严格的SQL查询检测无效字符：
```
SELECT name FROM offers WHERE name NOT REGEXP '^[\\x00-\\x7F\\xC2-\\xF4][\\x80-\\xBF]*$';
```
PHP mbstring扩展配置异常
即使default_charset设为UTF-8，如果mbstring.internal_encoding未同步设置为UTF-8，Laravel和Nova在处理多字节字符时会出现编码不一致问题。
排查：执行php -i | grep mbstring.internal_encoding查看配置，若不是UTF-8，在php.ini中设置mbstring.internal_encoding = UTF-8。
Nova字段自定义逻辑或第三方扩展干扰
若给Name字段添加了自定义过滤器、解析器，或使用了第三方Nova工具包，这些组件可能未正确处理UTF-8编码。
排查：临时移除字段的额外自定义方法（保留基础的Text::make），或禁用第三方Nova插件，测试是否仍报错。
数据插入时编码转换不完整
若数据来自外部来源（如CSV导入、第三方API），原数据编码可能不是UTF-8，插入时自动转换过程中残留了无效字节，即使数据库存储看似正常，Nova读取后仍会报错。
排查：检查数据插入流程，确保外部数据在插入前用mb_convert_encoding转换为UTF-8。

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