Nginx 中使用 xslt_stylesheet 指令需启用 http_xslt 模块（编译时加 --with-http_xslt_module），配合 xslt_types、xslt_param 等指令，将后端 XML 响应（如 RSS）在服务器端动态转为 HTML 等格式，要求模块存在、路径正确、XML 良构且仅支持 XSLT 1.0。
在 Nginx 中使用 xslt_stylesheet 指令进行服务器端 XSLT 转换，需要启用 http_xslt 模块（Nginx 官方模块，但默认不编译进大多数发行版二进制包），并配合 xslt_types、xslt_param 等指令协同工作。它适用于将后端返回的 XML 响应（如 RSS、自定义 API XML）动态转换为 HTML、纯文本或其他格式，由 Nginx 在响应发出前完成转换，不依赖应用层。
确认模块已启用并配置基础支持
Nginx 必须带 --with-http_xslt_module 编译选项。Ubuntu/Debian 的官方包通常不含此模块，需自行编译或使用第三方仓库（如 nginx-extras）。验证方式：
- 运行
nginx -V 2>&1 | grep -o with-http_xslt_module，有输出表示已启用 - 若无，需重新编译或换用含该模块的安装源
- 模块依赖系统级 libxml2 和 libxslt 开发库（如 Ubuntu 上装
libxml2-dev libxslt1-dev）
配置 location 并指定 XSLT 样式表文件
xslt_stylesheet 必须放在 location 块中，且仅对匹配的响应内容类型生效（默认只处理 text/xml 和 application/xml）：
location /feed.xml {
proxy_pass http://backend/feed.xml;
xslt_stylesheet /var/www/xslt/rss2html.xsl;
xslt_types text/xml application/xml;
}-
/var/www/xslt/rss2html.xsl是绝对路径，Nginx 主进程需有读取权限 -
xslt_types扩展支持的 MIME 类型，例如加application/rss+xml可让 RSS 响应也被转换 - 注意：该指令不支持变量（如
$arg_style），样式表路径必须是静态文件路径
传递参数与控制输出行为
可通过 xslt_param 向 XSLT 传递参数（作为顶层 xsl:param 使用），也可用 xslt_string_param 传字符串（避免 XPath 解析）：
xslt_param title "Latest News"; xslt_string_param base_url "https://example.com"; xslt_param limit $arg_limit; # 支持变量，但值需为合法 XPath 字符串
- XSLT 文件中需声明对应参数：
-
xslt_string_param更安全，适合传 URL、用户输入等可能含特殊字符的内容 - 所有参数值在 Nginx 中以字符串形式注入，XSLT 内不可直接执行逻辑判断（需靠 XSLT 自身实现）
调试常见问题
转换失败时 Nginx 默认静默忽略（返回原始 XML），需主动开启日志定位问题：
- 在
http或location块中添加：error_log /var/log/nginx/xslt.log debug;（需编译时含--with-debug） - 检查 XSLT 是否语法正确（可用
xsltproc命令行工具本地验证：xsltproc rss2html.xsl feed.xml） - 确保后端返回的 XML 是良构的（无编码声明冲突、UTF-8 BOM、标签未闭合等问题）
- 注意 Nginx 不支持 XSLT 2.0+，仅兼容 libxslt 实现的 XSLT 1.0 特性
基本上就这些。只要模块就位、路径正确、XML 规范，XSLT 转换就能在 Nginx 层干净地完成，减轻后端负担，也便于统一前端呈现逻辑。
