指令参考

ssi_silent_errors

'ssi_silent_errors' 指令用于在 NGINX 中启用或禁用对由 SSI 命令生成的错误消息的抑制。 — NGINX HTTP Core

ssi_silent_errors
httpserverlocation
语法ssi_silent_errors on | off;
默认值off
上下文http, server, location
模块NGINX HTTP Core
参数flag

说明

'ssi_silent_errors' 指令是 NGINX 服务器配置的一部分，主要与 Server-Side Includes (SSI) 功能配合使用。当该指令设置为 'on' 时，在处理 SSI 指令期间发生的任何错误都不会作为响应的一部分返回给客户端。相反，NGINX 会抑制这些错误，从而允许服务器继续传递内容，而不显示由于缺失文件、无效指令或其他与 SSI 相关的错误可能引起的任何错误。如果将 'ssi_silent_errors' 设置为 'off'（这是默认行为），客户端将收到这些问题的标准错误消息，这在调试时可能有用，但也可能向客户端暴露内部服务器细节。 对于依赖 SSI 的 Web 应用，使用 'ssi_silent_errors' 可以通过确保非致命的 SSI 错误不会中断内容交付来改善用户体验。然而，开发人员应注意，虽然它对用户隐藏了错误，但可能会使故障排查变得复杂，因为服务器日志中会包含这些错误，而客户端则看不到。需要在调试时的错误可见性与良好的用户体验之间取得平衡。

配置示例

location /includes/ {
    ssi on;
    ssi_silent_errors on;
    # Other configuration options
}
⚠

将 'ssi_silent_errors' 设置为 'on' 可能导致在 SSI 处理过程中出现未被注意到的问题，从而影响内容生成。

⚠

当 'ssi_silent_errors' 启用时，请记得检查服务器日志中的错误，而不要依赖客户端反馈。

相关指令

ssissi_types