TYPO3 11.5.30升级Bootstrap后出现mb_split未定义函数错误求助

问题原因 #

报错提示Call to undefined function TYPO3\HtmlSanitizer\Serializer\mb_split()，mb_split()属于PHP的mbstring多字节字符串扩展，TYPO3 11.5.30版本依赖的html-sanitizer组件需要该扩展支持，你的服务器环境未启用mbstring扩展，导致页面无法正常渲染。

解决步骤 #

• 检查mbstring扩展状态
  执行命令确认扩展是否已启用：

  php -m | grep mbstring
  

  无输出则说明mbstring未启用。

• 启用mbstring扩展
  根据服务器环境选择对应操作：

  1. Debian/Ubuntu系统（Apache/Nginx）

     sudo apt-get install php-mbstring
     # 重启Web服务，Apache示例：
     sudo systemctl restart apache2
     # Nginx示例：
     sudo systemctl restart nginx
     

  2. 通过php.ini配置启用
     先执行php --ini找到php.ini文件路径，打开后移除以下行的注释分号：

     ;extension=mbstring
     

     保存后重启Web服务。

• 验证修复效果
  重新访问报错页面，确认页面是否正常加载；也可再次执行php -m | grep mbstring，确认扩展已出现在列表中。

补充说明 #

TYPO3 11.5.x版本对PHP扩展有明确依赖要求，mbstring是官方指定的必需扩展之一，后续升级前建议核对官方系统要求，确保所有依赖扩展均已安装启用，避免同类问题。

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