Laravel中Str::substr截取未转义字符串无返回值如何解决

你遇到的截断后无内容问题，本质不是Str::substr返回空值，而是截断后的内容全是未闭合的HTML标签、标签属性片段，被浏览器识别为HTML标记解析，没有可渲染的可见文本，视觉上看起来像没有返回任何内容。

快速验证方法 #

把截断后的内容改用Blade转义语法输出，就能看到实际返回的原始字符串：

{{ Str::substr($post->content, 0, 30) }}

90%以上的场景你会看到输出内容类似<div class="rich-content"><p style="font-size:1，完全是HTML标签内部的片段，没有任何可见的正文文本，浏览器不会渲染标签属性内容，自然显示空白。

修复方案 #

根据你的需求选对应实现：

• 需求是输出纯文本摘要（最常见场景）
  不要直接截断原始HTML字符串，先过滤所有HTML标签再做截断，优先用Str::limit代替Str::substr：前者原生支持多字节字符（中文、特殊符号等）不会出现乱码，还会自动在截断末尾追加省略号：

  {!! Str::limit(strip_tags($post->content), 30) !!}
  

  如果内容开头存在大量不可见控制字符、Unicode BOM头，可以先做trim预处理：

  {!! Str::limit(trim(strip_tags($post->content)), 30) !!}
  

• 需求是保留基础HTML格式的摘要
  不要用原生字符串截断函数处理富文本，这类函数不会识别HTML标签结构，很容易把标签截断成不完整片段导致渲染异常。请使用支持HTML安全截断的工具处理内容，保证截断后所有HTML标签正确闭合，不会出现半截标签被浏览器吞掉的问题。

其他少见诱因排查 #

• 确认$post->content字段存储的不是压缩、加密后的二进制内容，如果是需要先完成解压、解密逻辑再做截断
• 确认代码中引入的Str类是Illuminate\Support\Str，错误引入其他同名类会导致方法行为不符合预期
• 如果模型中为content字段定义了访问器，确认访问器返回的是完整字符串类型内容，没有做特殊过滤返回空值

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