jpeg_filter_graceful
指令 `jpeg_filter_graceful` 控制在 JPEG 处理失败时是否返回未修改的图像。
NGINX JPEG filter module
·
httpserverlocation
语法jpeg_filter_graceful on | off;
默认值off
上下文http, server, location
参数flag
说明
jpeg_filter_graceful 指令在 NGINX 的 JPEG 过滤模块中使用，用于定义当处理 JPEG 图像出错时服务器的行为。当启用此指令（on）时，如果处理失败，服务器不会向客户端返回错误响应，而是发送原始的、未修改的图像。这对于保持无缝的用户体验尤其有用，因为即便请求的过滤或覆盖操作无法成功完成，用户仍能收到有效的图像。
该指令接受一个布尔标志参数，可设置为 on（启用优雅回退）或 off（禁用此功能）。默认情况下，jpeg_filter_graceful 的值为 off，这意味着在处理失败时服务器将返回错误响应。启用时，务必要确保原始图像仍然可访问，因为检索原始图像时的任何问题（例如文件权限或文件未找到错误）都可能抵消该指令的优点。
该指令可包含在多个上下文中，包括 http、server 和 location，使您能够在 NGINX 配置的不同层级应用它。在那些需要保持一致图像显示的场景中（例如电子商务或作品集网站，图像可能会被动态实时处理且必须保留用户体验），该指令尤其有用。
配置示例
location /images/ {
jpeg_filter on;
jpeg_filter_graceful on;
jpeg_filter_effect tintblue 50;
}⚠
确保原始图像可访问；如果不可访问，则回退机制将失败。
⚠
在应用中使用 jpeg_filter_graceful 而没有适当的错误处理，如果原始图像丢失，可能会导致较差的用户体验。