Tyk API网关请求体模板转换未生效，请求未转换直接转发

以下是按影响优先级排序的具体问题及修复方式：

1. 配置层级错误（核心原因） #

你当前API定义里的extended_paths字段放置层级错误，该字段必须属于对应版本（即你配置的Default版本）对象的子属性，你现在把它放在了和Default平级的versions对象下，Tyk加载配置时根本不会读取这段transform规则，自然不会执行转换。
错误结构片段：

"versions": {
    "Default": {
        "name": "Default",
        "use_extended_paths": true
    }, // 此处提前闭合了Default版本对象
    "extended_paths": { // 该字段与Default平级，属于无效配置
        "transform": [...]
    }
}

修正后的正确层级：

"version_data": {
    "not_versioned": true,
    "versions": {
        "Default": {
            "name": "Default",
            "use_extended_paths": true,
            "extended_paths": {
                "transform": [
                    {
                        "path": "/",
                        "method": "POST",
                        "template_data": {
                            "template_mode": "file",
                            "template_source": "/opt/tyk-gateway/templates/transform_test.tmpl"
                        }
                    }
                ]
            }
        }    
    }
}

2. 转换路径匹配错误 #

你配置的网关监听路径是/widgets，且开启了strip_listen_path: true，Tyk执行路径类中间件匹配时，匹配的是剥离监听前缀后的上游路径：如果你请求网关的地址是http://{网关IP}/widgets，剥离前缀后剩余的路径是/，和你之前配置的path: "/widgets"完全不匹配，规则不会触发。
修复方式：把transform规则内的path字段值改为/即可。如果后续需要匹配/widgets下的子路径，比如请求/widgets/foo，对应规则内的path写/foo。

3. Docker环境模板文件不可读 #

你配置的模板路径./templates/transform_test.tmpl是相对路径，Docker版Tyk网关的进程工作目录为容器内的/opt/tyk-gateway，如果你没有提前将宿主机存放模板的目录挂载到容器内的对应路径，网关会读取不到模板文件，且多数版本不会抛出明确错误，直接透传原始请求。
修复方式：

• 启动容器时将宿主机存放模板的目录挂载到容器内，例如把宿主机的./templates目录挂载到容器/opt/tyk-gateway/templates路径
• 配置内的模板路径改为容器内的绝对路径，不要使用相对路径
• 修改配置后执行Tyk热重载接口，或者重启网关容器让配置生效

4. 缺少必要请求头 #

发送测试请求时必须携带Content-Type: application/json请求头，否则Tyk不会将请求体解析为JSON结构传入模板引擎，模板无法读取到value1/value2等字段，会直接渲染失败透传原始请求。 #

修复完成后按以下逻辑验证：

• 发送POST请求到网关地址/widgets路径，携带正确的Content-Type头，请求体使用你之前准备的测试JSON
• 后端Express服务收到的请求体将是value1/value2互换、value_list按模板规则处理后的内容

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