Nginx 无法动态修改 XML 内容，ngx_http_xslt_module 仅支持基于 XSLT 1.0 的服务器端静态转换；可通过 xslt_param 传参实现请求级动态输出，需代理 XML 接口并配置 xslt_stylesheet 与 xslt_types。

Nginx 本身不提供“动态修改 XML 内容”的原生能力，`ngx_http_xslt_module` 的作用是**服务器端静态转换**：它把原始 XML 响应（来自文件或后端）用 XSLT 1.0 样式表**一次性结构化重写为 HTML、文本或模拟 JSON 字符串**，不是在 DOM 层做增删改查式的编辑。 要实现“动态修改 XML 内容”，关键不在模块是否“动态加载”，而在于**如何让 XSLT 转换行为随请求变化**——比如根据 URL 参数、Header 或客户端特征输出不同结构的 XML/HTML。以下是实际可落地的配置逻辑：

确认 xslt 模块已可用

该模块不是默认启用的，需验证：

• 运行 nginx -V 2>&1 | grep with-http_xslt_module，有输出才表示编译时已加入
• 若无，Ubuntu/Debian 推荐安装 nginx-extras 包；CentOS/RHEL 需手动编译并带上 --with-http_xslt_module
• 系统必须装有 libxml2 和 libxslt 运行库（如 apt install libxml2 libxslt1.1）

用 xslt_param 传参驱动动态转换

XSLT 本身是静态的，但可通过 Nginx 向样式表注入变量，让同一份 XSLT 输出不同结果。例如按语言切换字段：

Nginx Config Linter

对 Nginx 配置文件进行语法检查、验证和安全、性能审计。

下载

• Nginx 配置中添加：xslt_param lang $arg_lang;（从 URL 参数 ?lang=zh 获取）
• XSLT 文件中声明：<xsl:param name="lang" select="'en'" />
• 在模板中用 <xsl:choose> 分支控制内容：<xsl:when test="$lang = 'zh">用户</xsl:when>

代理 XML 接口 + 实时转换

不服务静态文件，而是对后端返回的 XML 动态加工：

• 配置 location 代理到上游 XML 接口：proxy_pass http://api/users;
• 加上转换指令：xslt_stylesheet /etc/nginx/xslt/user-list.xsl;
• 指定生效类型：xslt_types application/xml text/xml;（必须与后端实际 Content-Type 一致）
• 强制响应类型（如转成 HTML）：add_header Content-Type text/html;

注意事项与限制

这不是 JavaScript 式的灵活编辑，而是受 XSLT 1.0 严格约束的声明式转换：

• 不支持 XSLT 2.0/3.0 函数（如 replace()、正则匹配），字符串处理靠 <xsl:value-of> 和 <xsl:if> 组合
• 不能修改原始 XML 的命名空间或文档结构以外的元信息（如 XML 声明、注释、处理指令）
• 所有参数值都是字符串，数字或布尔需在 XSLT 中显式判断（如 test="$limit > 10"）
• 样式表路径必须是绝对路径，不支持变量（$xslt_path 无效）

不复杂但容易忽略。