Mustache模板变量访问问题：Swagger Codegen扩展字段取值为空

我之前在使用Swagger Codegen处理供应商扩展字段时，也碰到过一模一样的问题！核心原因其实是**x-rate-limit被解析成了数组类型**，但你可能在错误的上下文里直接访问name和value，导致取不到值。

为什么会出现这种情况？ #

当你在{{#x-rate-limit}}和{{/x-rate-limit}}标签内用{{.}}能正常遍历，说明x-rate-limit是一个数组（哪怕里面只有一个元素）。而如果你在这个块外面直接写{{x-rate-limit.name}}，Mustache会在当前父上下文找x-rate-limit的name属性——但数组本身没有name属性，自然返回空。

具体解决方案 #

1. 先确认数据结构（关键！）

先在模板里加一行代码，打印出当前上下文的完整JSON结构，搞清楚x-rate-limit到底是什么类型：

{{{json .}}}

（用三个大括号是为了避免HTML转义，能看到原始JSON）

你大概率会看到类似这样的结构：

{
  // 其他字段...
  "x-rate-limit": [
    { "name": "request-limit", "value": "500" },
    { "name": "window", "value": "1h" }
  ]
}

2. 正确遍历数组访问属性

既然是数组，就必须在{{#x-rate-limit}}的块内访问每个元素的name和value：

{{#x-rate-limit}}
  <div>Rate Limit Rule: {{name}} = {{value}}</div>
{{/x-rate-limit}}

这样就能正常输出每个规则的名称和值了。

3. 如果x-rate-limit本应是单个对象

如果你在Swagger定义里写的x-rate-limit是单个对象，但被Codegen解析成了数组，可能是定义时不小心加了方括号。这时候有两种处理方式：

• 修改Swagger定义，把x-rate-limit的方括号去掉，改成单个对象；
• 或者在模板里直接取数组的第一个元素：

  {{#x-rate-limit.0}}
    Name: {{name}}, Value: {{value}}
  {{/x-rate-limit.0}}
  

4. 排查Codegen版本或配置

有些旧版本的Swagger Codegen对供应商扩展的解析可能有bug，建议升级到较新的稳定版本。另外，生成代码时可以检查是否开启了扩展支持的配置，比如使用--additional-properties参数传递相关设置。

总结 #

本质就是要匹配x-rate-limit在模板数据中的实际类型：数组就用块遍历访问元素属性，单个对象就直接访问。先打印完整数据结构确认类型，再调整模板写法，问题就能解决啦！

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