Craft CMS调用Matrix块text()方法提示未知方法运行错误

错误根因 #

报错Calling unknown method: craft\elements\MatrixBlock::text()的触发逻辑非常明确：Twig解析{{ block.text }}时，没有在当前遍历到的Matrix块实例上找到句柄为text的自定义字段，就会fallback尝试调用类的text()成员方法，而MatrixBlock类本身没有定义这个方法，最终抛出运行时错误。
你贴的模板代码和官方示例完全一致，不存在语法问题，故障100%来自后台Matrix字段配置和模板引用的句柄不匹配——入门教程里的代码是和教程约定的字段命名强绑定的，只要建字段/块类型时句柄填的和教程要求不一样，哪怕差一个字母、大小写不对，都会触发这个问题。

修复步骤 #

• 登录Craft后台，找到对应频道（Section）中绑定的Matrix字段，也就是模板里entry.postContent对应的字段（教程中该字段的句柄为postContent），打开字段编辑页。
• 核对第一个文本类块类型的配置：
  • 块类型本身的句柄必须为text（注意是机器可读的handle值，不是后台显示的展示名称，必须全小写、拼写完全一致）。如果你建块类型时句柄填成了body、richtext这类自定义值，要么把句柄改成text，要么把模板里的判断条件{% if block.type == 'text' %}改成你实际使用的块类型句柄。
  • 进入该块类型的字段列表，找到存放正文内容的文本/富文本字段，确认它的句柄为text。如果建字段时你把句柄设成了其他值，要么修改字段句柄为text，要么把模板里的输出代码{{ block.text }}替换为对应句柄，比如字段句柄是body就写{{ block.body }}。
• 核对第二个图片类块类型的配置，避免后续触发同类错误：块类型句柄必须为image，块内部关联资产的图片字段句柄必须为image，和模板里block.type == 'image'、block.image.all()的引用保持一致。
• 所有配置修改完成后，进入后台「实用工具」-「清除缓存」页面，全选系统缓存项执行清除，避免旧配置缓存导致修改不生效。

注意事项 #

Craft模板里所有对内容字段的调用，都是严格匹配后台配置的字段/块类型句柄的，入门教程里每一步提到的句柄命名都要完全照搬，不要自行修改命名后忘记同步调整模板代码，这类拼写/命名不匹配的问题是新手最容易踩的坑。

内容的提问来源于stack exchange，提问作者C. Mack