【Bug已解决】Mustache list sections silently drop falsy items (0,False,)一、现象长什么样某些 LangChain 组件如 prompt 模板把变量渲染成文本、或把结构化结果喂给支持 Mustache 的下游用了 Mustache 风格的列表段section来渲染一个列表。当列表里包含假值falsy元素——0、False、、None——这些元素会被静默丢弃渲染结果里根本不出现它们。比如模板{{#items}}- {{.}} {{/items}}数据items [1, 0, 2, False, ]期望渲染出五行实际只渲染了1和2两行。0、False、消失了。如果这是把工具返回的数值列表渲染给用户或者把检索命中的分数列表渲染进 prompt丢掉的0/False会改变语义比如一个布尔结果的False被丢看起来像没有结果造成推理错误且没有任何报错。二、背景Mustache 的 section 语义是真值才渲染当 section 的值是一个非空列表迭代渲染每个元素。但当列表里的单个元素是 falsy0/False//None时部分 Mustache 实现以及不少类 Mustache的迷你模板器对每个元素先做真值判断falsy 元素直接跳过该次迭代。更糟的是当 section 的值本身是单个 falsy 标量0/False整个 section 不渲染。问题根源在迭代每个元素时也套用了 section 的真值规则。严格 Mustache 规范对列表元素其实是用上下文 push但很多轻量实现为了求快对元素做了if value:判断于是0/False被当假跳过。三、根因根因两点迭代时对元素做真值判断渲染列表段时对每个元素执行if item:falsy 元素被跳过。规范本应只判断是不是列表/要不要迭代不该判断元素真假。无数据保全意识模板器把渲染当成了过滤把 falsy 当成不应显示但调用方要的是原样列出所有元素。本质把section 是否渲染的真值语义错误地延续到了列表里每个元素是否渲染混淆了段存在性与元素值。四、最小可运行复现下面缩略逻辑复现静默丢弃def bad_render(template_items, items): # 类 Mustache对每个元素做真值判断 out [] for it in items: if it: # 错误falsy 元素被跳过 out.append(f- {it}) return \n.join(out) print(bad_render(None, [1, 0, 2, False, ])) # 只输出 - 1 和 - 20/False/ 丢失修复列表段只判断是否列表元素原样渲染falsy 也渲染。def good_render(items): out [] for it in items: out.append(f- {it}) # 不判断真假原样列出 return \n.join(out)五、解决方案第一层最小直接修复最小修法在列表段渲染时只对值是否为可迭代列表做判断进入迭代后不对元素做真值过滤falsy 元素也要渲染空字符串渲染为空行0/False 渲染成其字面量。def render_list_section(items): if not isinstance(items, (list, tuple)): # 非列表按普通 section 真值规则 return None if items is False or items is None else block lines [] for it in items: # 关键不判断 it 真假原样渲染 lines.append(f- {it!r} if it is False or it 0 or it else f- {it}) return \n.join(lines)这一层保证0/False/都出现在输出里语义不丢。六、解决方案第二层结构化改进把列表段渲染规则固化成策略对象作为单一事实来源明确 falsy 元素是否保留。from dataclasses import dataclass dataclass(frozenTrue) class LangChainMustacheListPolicy: Mustache 列表段渲染策略的单一事实来源。 keep_falsy_items: bool True falsy_literal: dict None # 如何呈现 falsy def render_items(self, items) - str: if not isinstance(items, (list, tuple)): raise TypeError(list section needs a list) lines [] for it in items: if it is False: lines.append(- false) elif it 0 and not isinstance(it, bool): lines.append(- 0) elif it : lines.append(- (empty)) else: lines.append(f- {it}) return \n.join(lines) def validate(self) - None: if not self.keep_falsy_items: raise AssertionError(must keep falsy items to preserve data)模板器用policy.render_itemsfalsy 保全成为硬规则。七、解决方案第三层断言 / CI 守护用 pytest 锁死 falsy 保全import pytest from policy import LangChainMustacheListPolicy as P def test_falsy_preserved(): p P() out p.render_items([1, 0, 2, False, ]) assert 0 in out and false in out and (empty) in out def test_count_matches(): p P() out p.render_items([1, 0, False, ]) # 4 个元素都应有对应行 assert out.count(-) 4 def test_requires_keep_falsy(): with pytest.raises(AssertionError): P(keep_falsy_itemsFalse).validate() def test_non_list_rejected(): import pytest with pytest.raises(TypeError): P().render_items(not a list)CI 加一条模板渲染单测必须覆盖含0/False/的列表断言元素数量不丢。八、排查清单渲染出的列表少了几个元素→ 列表段对 falsy 元素做了真值跳过。0/False/消失了→ 迭代时if item:把它们过滤了。是否只判断是否列表→ 进入迭代后不应再判元素真假。布尔结果False被当无结果→ 需原样渲染false。用的是标准 Mustache 还是自制模板器→ 自制的更易踩这个坑。是否有元素数不变的测试→ 必须有数量一致性断言。九、小结Mustache 列表段在部分实现里对每个元素套用真值判断导致0/False/被静默丢弃改变渲染语义且无声无息。根因是混淆了section 是否渲染与列表元素是否渲染把过滤当成了保全。第一层改为只对是否列表判断、元素原样渲染第二层用LangChainMustacheListPolicy把 falsy 保全固化成单一事实来源第三层用 pytest 守护元素数量不丢。模板渲染的通用原则迭代列表时只判断是不是列表绝不对元素做真值过滤否则数据在渲染期就丢了。