---
title: "ngx_mruby v2.7.12"
language: "ja"
documentation_version: "2.x"
channel: "maintenance"
release_context: {"latest_release_tag":"v2.7.12","unreleased_versions":[],"latest_release_revision":"49d26b879df732f8260f8454b90b0774789ef818"}
source_revision: "49d26b879df732f8260f8454b90b0774789ef818"
working_tree_clean: true
source_path: "docs/releases/v2.7.12.ja.md"
source_sha256: "517f48a06ea8a9a1f270f00067814360405b29a3f691157d8be36b7c2af3a651"
source_at_revision: true
source_url: "https://github.com/matsumotory/ngx_mruby/blob/49d26b879df732f8260f8454b90b0774789ef818/docs/releases/v2.7.12.ja.md"
html_url: "https://ngx.mruby.org/v2/ja/releases/v2.7.12/"
markdown_url: "https://ngx.mruby.org/v2/markdown/ja/releases/v2.7.12.md"
last_updated: "2026-11-18"
---

# ngx_mruby v2.7.12

## 更新前に確認する挙動の変更

### 1. mrubyの出力フィルタを通るHEAD、204、304のレスポンスの後も、接続を再利用できる(#853)

- 変更前：ヘッダだけで終わるレスポンスがmrubyの出力フィルタを通ると、クライアントは`Connection: keep-alive`の付いたヘッダを受け取り、その後にnginxが接続を閉じていました。こうしたレスポンスには、HEADのリクエストへのレスポンス、`If-Modified-Since`か`If-None-Match`の付いたGETにnginxが返す304、`return 204;`のような204があります。クライアントがその接続で次に送ったリクエストには、レスポンスが返りませんでした。`mruby_output_header_filter`か`mruby_output_header_filter_code`を持ち、mrubyのボディフィルタを持たないlocationでは、HEAD、204、304のすべてで起きていました。`mruby_output_body_filter`か`mruby_output_body_filter_code`を持つlocationでは、`autoindex`の一覧や、`Content-Length`をnginxが取り除く静的なファイルの304のように`Content-Length`の無いレスポンスで起きていました。nginxが`Content-Length`を0にする`return 204;`の204のように、`Content-Length`のある204と304でも起きていました。ボディフィルタを通る、長さの分かっているHEADのレスポンスの後は、2.7.5から接続を再利用できていました(#752)。
- 変更後：HEADのリクエストへのレスポンスと、204と304のレスポンスは、ヘッダで終わります。このレスポンスのヘッダをnginxが送った後、ngx_mrubyは、ヘッダの送信の結果をそのまま返し、ボディを次のフィルタに渡しません。ヘッダでレスポンスが終わるときにnginx自身のハンドラが行うのと同じ扱いです。nginxは、再利用できる接続を次のリクエストのために開いておきます。クライアントが受け取るステータスとヘッダは変わらず、ヘッダの後にボディのバイトは続きません。次の3つは、これまでどおりに扱います。GETのレスポンス、ヘッダの送信の結果が`NGX_ERROR`の場合、フィルタのコードがエラーになった場合です。
- 変更の理由：
  - 不具合：nginxのヘッダフィルタは、HEAD、204、304のレスポンスのヘッダを送るときに`r->header_only`を設定します。ngx_mrubyがヘッダを次のフィルタに渡す3か所は、ヘッダを送れていても、このフラグが立っていると`NGX_ERROR`を返していました。1つ目は、ボディフィルタの無いlocationで、ヘッダフィルタのコードを動かした後です。2つ目は、ボディフィルタが、長さの無いレスポンスを扱うときです。3つ目は、ボディフィルタのコードを動かした後の`ngx_mrb_finalize_body_filter`で、2.7.5からはHEAD以外のメソッドで`NGX_ERROR`を返していました。静的なファイルのハンドラ、`return`、`autoindex`のようなnginxのハンドラは、その`NGX_ERROR`をそのまま返すので、nginxはリクエストを失敗として終え、接続を閉じていました。3.0.0の開発ブランチでは、同じ不具合を#848と#849で直しています。
  - 前の挙動を残せなかった理由：nginxが正常に送ったHEAD、204、304のレスポンスは、出力のエラーではありません。nginxが接続を閉じていたので、keep-aliveで接続が続くと見込んでクライアントが送った次のリクエストが失われていました。locationのレスポンスにヘッダを足すヘッダフィルタがあると、そのlocationの静的なファイルへの条件付きGETのうち、クライアントがキャッシュを使えるものは、すべて接続を閉じられていました。
  - ドキュメントが示していた挙動：[2.7.11のディレクティブのドキュメント](https://github.com/matsumotory/ngx_mruby/blob/v2.7.11/docs/directives/README.md#mruby_output_body_filter-mruby_output_body_filter_code-mruby_output_header_filter-and-mruby_output_header_filter_code)は、出力フィルタのあるlocationでのHEAD、204、304のレスポンスについて、何も書いていませんでした。[Nginx::Filter#body=](https://github.com/matsumotory/ngx_mruby/blob/v2.7.11/docs/class_and_method/README.md#nginxfilterbodystring)は、ボディフィルタを通る長さの分かっているHEADのレスポンスの後は接続を使えること、ヘッダだけで終わるほかのレスポンスの挙動は変わらないことを書いていました。
- 影響の範囲：mrubyの出力ヘッダフィルタか出力ボディフィルタを通るHEAD、204、304のレスポンスです。挙動が変わるのは、接続を再利用できる場合です。
- 必要な対応：対応は不要です。接続を意図して閉じたいときは、これまでのように接続が閉じられることに頼らず、nginxのkeep-aliveの設定(`keepalive_timeout`、`keepalive_requests`)を使ってください。
- テスト：ポート18112です(`test/conf/conf.d/20-filter-connection.conf`、`test/t/cases/head_header_filter.rb`、`test/t/cases/header_only_keepalive.rb`)。

### 2. `Nginx::Headers_in#[]=`で置き換えたリクエストヘッダは、リクエストの最後のヘッダだった場合も、スクリプトの値が中継先へ送られる(#858)

- 変更前：スクリプトが`Nginx::Headers_in#[]=`でリクエストヘッダを置き換え、置き換えたヘッダがリクエストの最後のヘッダだった場合(たとえば`Host`だけのリクエスト)、設定によっては、`proxy_pass`と`grpc_pass`はスクリプトの値を送らず、その名前について`proxy_set_header`(か`grpc_set_header`)の値か、nginx自身の値だけを送りました。置き換えたヘッダの後ろにほかのヘッダがあった場合と、スクリプトが新しい名前を足した場合は、スクリプトの値も、`proxy_set_header`かnginxの値と並んで送られていました。ただし、設定によっては、workerプロセスが終了することもありました(「不具合の修正」を参照)。
- 変更後：これらのどの場合も、置き換えたヘッダがリクエストのどこにあったかによらず、スクリプトの値も送られます。
- 変更の理由：
  - 不具合：`[]=`で足したヘッダには`lowcase_key`と`next`が設定されておらず、`proxy_pass`か`grpc_pass`でリクエストを送るときに、nginxがそれを読んでいました(「不具合の修正」を参照)。スクリプトのヘッダをモジュールが外すかどうかは、nginxが読んだ値で決まっていました。
  - 前の挙動を残せなかった理由：修正では2つのフィールドを設定し、その値によって、どの場合も同じ結果になります。2.xでは、スクリプトが足したヘッダを、これらのモジュールが設定するヘッダの名前と照らし合わせません。最後のヘッダを置き換えた場合を除けば、これまでもそうなっていました。
  - ドキュメントが示していた挙動：[2.7.11のNginx::Headers_in#[]=](https://github.com/matsumotory/ngx_mruby/blob/v2.7.11/docs/class_and_method/README.md#nginxheaders_instring-string)は、リクエストヘッダの値を設定すると書いていました。`proxy_pass`と`grpc_pass`については、何も書いていませんでした。
- 影響の範囲：`proxy_pass`か`grpc_pass`を使うlocationで、`proxy_set_header`(か`grpc_set_header`)かモジュール自身も設定するリクエストヘッダ(`Host`など)を、スクリプトが`Nginx::Headers_in#[]=`で置き換えていて、そのヘッダが最後のヘッダになるリクエストがある場合です。`Host`の場合は、そのようなリクエストでも、ほかのリクエストと同じく、中継先が`Host`の行を2つ受け取り、中継先がnginxなら400を返します。
- 必要な対応：スクリプトの値だけを送るには、そのヘッダを`Nginx::Headers_in#[]=`で設定せず、値を変数に入れて`proxy_set_header`に渡してください。たとえば`mruby_set_code $backend_host '...';`か、`set`で宣言した変数への`Nginx::Var`の代入で値を入れ、`proxy_set_header Host $backend_host;`(か`grpc_set_header`)と書きます。モジュール自身が設定しない名前なら、その名前の`proxy_set_header`を消しても、スクリプトの値だけが送られます。
- テスト：ポート18099と18100です(`test/conf/conf.d/74-headers-in-proxy.conf`、`test/t/cases/headers_in_proxy.rb`)。置き換えたヘッダの後ろにほかのヘッダがある場合、最後のヘッダの場合、ただ1つのヘッダの場合と、`Host`を置き換える場合、変数を`proxy_set_header`に渡す場合を確かめます。

## 新機能

ありません。

## 不具合の修正

- `return 204;`の204のような長さ0のレスポンスがmrubyの出力ボディフィルタを通るとき、ボディフィルタは、空のボディのコピーにNULLを渡さなくなりました。コピーするバイトは無く、レスポンスも変わりません。UndefinedBehaviorSanitizerを有効にしたビルドが、このコピーについて`null pointer passed as argument 1`を報告していました(#853)。
- `Nginx::Headers_in#[]=`か`Nginx::Headers_out#[]=`で足したヘッダに、`lowcase_key`と`next`を設定するようになりました。これまでは設定されておらず、`proxy_pass`か`grpc_pass`がリクエストを中継先へ送るときに、nginxのproxyモジュールかgrpcモジュールがその`lowcase_key`を読んでいました。設定によっては、workerプロセスが終了することがありました。足したヘッダは、`proxy_set_header`か`grpc_set_header`が同じ名前を設定している場合も含めて、中継先へ送られます。「更新前に確認する挙動の変更」の2つ目の項目も参照してください(#858)。

## ビルドとテストの変更

- `test/t/cases/head_header_filter.rb`と`test/t/cases/header_only_keepalive.rb`は、ヘッダだけで終わるレスポンスになるリクエストか、比較のためのリクエストを送り、その後に同じTCP接続でGETを送ります。送り先は、ポート18112のserverに足したlocationです(`test/conf/conf.d/20-filter-connection.conf`)。確かめるのは、次の場合です。ヘッダフィルタだけを通る`return`のレスポンスと静的なファイルのそれぞれへのHEAD、ボディフィルタを通る`autoindex`の一覧へのHEADです。この一覧は、ヘッダを1回の書き込みで送れないように毎秒50バイトで送る場合(`limit_rate 50`、`send_timeout 3s`)も確かめます。304と204を、ヘッダフィルタだけを通る場合とボディフィルタを通る場合のそれぞれで確かめます。304は、`if_modified_since before`を設定した静的なファイルに、`If-Modified-Since`の付いたGETを送ったときのレスポンスで、204は`return 204;`のレスポンスです。ボディフィルタのlocationが、ファイルより小さい出力バッファで読む静的なファイルには、`output_buffers 1 8`と`send_timeout 3s`を設定したうえで、`If-Modified-Since`の付いたGETとHEADを送り、どちらも304になることを確かめます。`test/t/cases/_head_filter_client.rb`は、省略できる3つ目の引数でリクエストヘッダの行を受け取れるようになり、204と304のときは、HEADと同じく、最初のレスポンスをヘッダまでで読み終えます(#853)。
- `test/t/cases/headers_in_proxy.rb`は、ポート18099と18100のserver(`test/conf/conf.d/74-headers-in-proxy.conf`)で、`proxy_pass`の前に`Nginx::Headers_in#[]=`でリクエストヘッダを足すか置き換え、中継先が受け取るヘッダを確かめます。確かめるのは、足したヘッダがすべて届くこと(`proxy_set_header`も設定する名前と、proxyモジュール自身が設定する名前も含む)、置き換えたヘッダがリクエストのどこにあっても届くこと、変数を通して`proxy_set_header`に渡した値が届くことです。#858より前のビルドをvalgrindで動かすと、ここで、設定されていない`lowcase_key`の読み取りが報告されます(#858)。

## アップグレード

- ディレクティブの追加、名前の変更、削除はありません。2.7.11と同じ方法でこのリリースのモジュールをビルドし、バイナリか動的モジュールをいつもどおり置き換えてください。`Nginx.module_version`は`2.7.12`を返します。
- mrubyの出力ヘッダフィルタか出力ボディフィルタを通るHEAD、204、304のレスポンス：対応は不要です。接続を意図して閉じたいときは、nginxのkeep-aliveを設定してください(#853)。
- `proxy_pass`か`grpc_pass`を使うlocationで、モジュールも設定する名前のリクエストヘッダを`Nginx::Headers_in#[]=`で置き換える場合：スクリプトの値だけを送るには、代わりに、値を変数に入れて`proxy_set_header`(か`grpc_set_header`)に渡してください(#858)。

アップグレードの前に、上の「更新前に確認する挙動の変更」を読んでください。
