store_http_read_retries
`store_http_read_retries` 指令定义在处理请求时读取 HTTP 响应的重试次数。
Kaltura Media Framework Common NGINX Module
语法store_http_read_retries number;
默认值none
上下文
参数1
说明
store_http_read_retries 指令是 NGINX 中 Kaltura Media Framework 实现的一部分，用于控制服务器在处理传入请求时从后端服务器读取的尝试次数。这在网络连接不可靠或后端服务可能间歇性无法正确响应的场景下尤其有用。通过配置该指令，管理员可以设置自定义的重试策略，以提高媒体流服务针对此类瞬时错误的弹性。
store_http_read_retries 设置后，每次从后端服务器读取失败都会触发重试，直到达到指定的尝试次数为止。该指令接受一个参数，该参数为整数值，表示在最终判定请求失败之前允许的最大重试次数。在需要保持无缝用户体验且临时后端错误不应导致流媒体服务立即失败的媒体流应用中，这一点非常重要。
需要注意的是，将重试次数设置过高可能会在服务器等待成功响应时增加客户端的延迟，而设置过低又可能在短暂的后端不可用期间导致请求失败。因此，在设置此值时需谨慎权衡可靠性与性能。
配置示例
server {
listen 80;
location /api {
store_http_read_retries 3;
}
}⚠
将重试次数设置得过高可能会显著增加用户请求的延迟。
⚠
如果后端服务持续无响应，此设置可能会在请求失败之前导致请求处理时间延长。
⚠
该指令仅适用于 HTTP 读取操作，不影响连接建立阶段。