---
title: "ngx_mruby v2.7.9"
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.9.ja.md"
source_sha256: "6a6de72350bd5f94e6c2eb94991ea1a708d0848bc79e561fed0cddc2099e7625"
source_at_revision: true
source_url: "https://github.com/matsumotory/ngx_mruby/blob/49d26b879df732f8260f8454b90b0774789ef818/docs/releases/v2.7.9.ja.md"
html_url: "https://ngx.mruby.org/v2/ja/releases/v2.7.9/"
markdown_url: "https://ngx.mruby.org/v2/markdown/ja/releases/v2.7.9.md"
last_updated: "2026-11-15"
---

# ngx_mruby v2.7.9

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

### `initialize`が例外を出したオブジェクトと、`dup`か`clone`で作ったコピーで、upstreamのメソッドは`nil`を返したりworkerを終わらせたりせず、`ArgumentError`を出します(#816、#819)

- 変更前：`Nginx::Upstream#initialize`と`Nginx::Stream::Connection#initialize`は、その名前のupstreamがあることを確かめる前に、オブジェクトにupstreamを持たせていました。upstreamのメソッドは、オブジェクトが持つupstreamを確かめずに読んでいました。スクリプトは、`initialize`が例外を出した後も、そのオブジェクトを持ち続けることができました。1つ目の例は、`allocate`で作ったオブジェクトで`initialize`を呼び、例外が出た場合です。2つ目の例は、スクリプトが`send`で`initialize`をもう一度呼び、その呼び出しが例外を出した場合です。3つ目の例は、`initialize`で`super`の例外を`rescue`するサブクラスのオブジェクトです。`allocate`で作り、`initialize`を一度も呼んでいないオブジェクトも、同じ状態でした。その名前のupstreamが無かったときは、`Nginx::Upstream#server`と`Nginx::Stream::Connection#upstream_server`は`nil`を返しました。`Nginx::Upstream#server=`、`#keepalive_cache`、`#keepalive_cache=`と`Nginx::Stream::Connection#upstream_server=`は、NULLポインタを参照し、workerプロセスはセグメンテーション違反で終わりました。upstreamに2つ以上のサーバーがあったとき、また`allocate`で作ったオブジェクトでは、`#server`と`#upstream_server`も含めて、これらのどのメソッドでも、同じようにworkerが終わりました。`dup`か`clone`で作ったコピーも、元が`.new`の返したオブジェクトであっても、upstreamを持っていませんでした。mrubyは、データオブジェクト(`RData`)をコピーするとき、インスタンス変数をコピーし、データはコピーしないからです。そのようなコピーでこれらのメソッドのどれかを呼ぶと、workerはセグメンテーション違反で終わり、そのHTTPのリクエストにもstreamのセッションにも応答は返りませんでした(#819)。
- 変更後：`initialize`は、upstreamとそのサーバーが見つかったときだけ、オブジェクトにupstreamを持たせます。upstreamを持たないオブジェクトでは、`Nginx::Upstream#server`、`#server=`、`#keepalive_cache`、`#keepalive_cache=`は`ArgumentError`を出し、メッセージは`uninitialized Nginx::Upstream`です。`Nginx::Stream::Connection#upstream_server`と`#upstream_server=`は`ArgumentError`を出し、メッセージは`uninitialized Nginx::Stream::Connection`です。スクリプトのほかの例外と同じように、この例外でもハンドラは終わります。スクリプトは`rescue`でこの例外を捕まえられます。捕まえなければ、ngx_mrubyは例外をログに書き、HTTPのリクエストには500を返し、streamのセッションは閉じます。workerは、次のリクエストとセッションを続けて処理します。例外を出した`initialize`の後に、`initialize`が成功すると、オブジェクトはupstreamを持ち、メソッドはまた動きます。`dup`か`clone`で作ったコピーはupstreamを持たず、メソッドはコピーでも同じ`ArgumentError`を出します。元のオブジェクトは、upstreamを持ち続けます(#819)。
- 変更の理由：
  - 不具合：`initialize`は、オブジェクトのコンテキストを確かめる前に保存していました。コンテキストは、upstream、そのピア、そのサーバーです。また、upstreamに2つ以上のサーバーがあると、古いコンテキストを解放した後、新しいコンテキストを保存する前に例外を出していました。メソッドは、そのコンテキストがupstreamを持つことを確かめずに読んでいました(#816)。
  - 前の挙動を残せなかった理由：upstreamを持たないオブジェクトには、返すサーバーも、変えるサーバーも、接続を保持するサーバーもありません。`#server`の`nil`は、空のコンテキストを読んだ結果で、メソッドが定めた値ではありませんでした。また、同じオブジェクトで次のメソッドを呼ぶとworkerが終わり、そのworkerが処理していたほかのリクエストも終わりました。そのようなオブジェクトでは、upstreamのすべてのメソッドが例外を出す以外に、取りうる挙動はありません。メッセージに`uninitialized`とクラスの名前を含む`ArgumentError`は、同梱のmrubyが、`initialize`が実行されていない自身のクラスのオブジェクトに対して出す例外です。`Time`の`uninitialized time`と、`Range`の`uninitialized range`がその例です。
  - ドキュメントが示していた挙動：2.7.8の[Nginx::Upstream#new](https://github.com/matsumotory/ngx_mruby/blob/v2.7.8/docs/class_and_method/README.md#nginxupstreamnewstring---upstream)と[Nginx::Stream::Connection#new](https://github.com/matsumotory/ngx_mruby/blob/v2.7.8/docs/class_and_method/README.md#nginxstreamconnectionnew)は、その名前のupstreamが無いとメソッドが`RuntimeError`を出すと書いていました。その後のオブジェクトについては、何も書いていませんでした。
- 影響の範囲：`Nginx::Upstream`か`Nginx::Stream::Connection`のオブジェクトを、`initialize`が例外を出した後も使い続けるスクリプト、`allocate`で作ったオブジェクトを使うスクリプト、これらのクラスのオブジェクトを`dup`か`clone`でコピーして使うスクリプト(#819)のうち、そのオブジェクトで`#server`、`#server=`、`#keepalive_cache`、`#keepalive_cache=`、`#upstream_server`、`#upstream_server=`を呼ぶものです。`Nginx::Upstream.new`か`Nginx::Stream::Connection.new`が返したオブジェクトは、これまでと同じように動きます。ただし、そのオブジェクトを`dup`か`clone`でコピーしたものは、これまでと同じようには動きません。`#remote_ip`や`#stream_status`のように、upstreamを使わない`Nginx::Stream::Connection`のメソッドは、影響を受けません。
- 必要な対応：オブジェクトは`Nginx::Upstream.new`か`Nginx::Stream::Connection.new`で作り、その呼び出しが例外を出したら使わないでください。別のupstreamを使うときは、別のオブジェクトを作ってください。オブジェクトを`dup`か`clone`でコピーしないでください。同じupstreamを使う2つ目のオブジェクトが必要なときは、`.new`で作ってください(#819)。upstreamを持たないオブジェクトでこれらのメソッドを呼ぶコードは、2.7.8では`nil`を受け取るか、workerを終わらせていました。

### `Nginx.module_version`と`error.log`の起動時の行は、2.7.1ではなく、リリースのバージョンの2.7.9を示します(#822)

- 変更前：2.7.2から2.7.8では、`Nginx.module_version`は`2.7.1`を返しました。nginxは、`http {}`ブロックのある設定を読み込むと、`error.log`にレベル`notice`で、`ngx_mruby/2.7.1 (mruby/3.3.0) mechanism enabled`で始まる行を書きました。nginxは、この文字列の後に、設定ファイルの名前と行番号を示す` in <file>:<line>`を付けます。
- 変更後：`Nginx.module_version`は`2.7.9`を返し、`error.log`の行は`ngx_mruby/2.7.9 (mruby/3.3.0) mechanism enabled`で始まります。以後のリリースも、自身のバージョンを示します。モジュールのバージョンが、`docs/releases/`にある最も新しいリリースのファイルのバージョンと異なると、テストスイートが失敗するからです。
- 変更の理由：
  - 不具合：どちらも、`src/http/ngx_http_mruby_module.h`の`MODULE_VERSION`を読みます。この値は2.7.1のリリースで`2.7.1`に設定され、その後の7回のリリースで一度も変更されていませんでした。`docs/releases/README.md`にあるリリースの手順は、この値を設定することも、確かめることも求めていませんでした(#822)。
  - 前の挙動を残せなかった理由：この値は、モジュールをビルドしたリリースを示す値です。2.7.2から2.7.8では、この値は2.7.1を示していましたが、2.7.1は修正の内容も挙動もそれらのリリースと異なります。そのため、この値を読むスクリプトや監視は、それらのリリースを2.7.1とも、互いにも区別できませんでした。`2.7.1`のままにすれば、2.7.9も同じ誤った値を返すことになります。
  - ドキュメントが示していた挙動：2.7.1のリリースノートの[アップグレード](/v2/ja/releases/v2.7.1/#アップグレード)の節は、`Nginx.module_version`がそのリリースのバージョンである`2.7.1`を返すと書いていました。2.7.8の[Nginx.module_version](https://github.com/matsumotory/ngx_mruby/blob/v2.7.8/docs/class_and_method/README.md#nginxmodule_version---string)は、このメソッドがngx_mrubyのバージョンを返すと書き、例として`0.0.1`を示していました。2.7.2から2.7.8のリリースノートは、この値に触れていませんでした。
- 影響の範囲：`Nginx.module_version`が返す文字列を比べるスクリプトです。たとえば、`2.7.1`と比べるスクリプトや、バージョンによって実行するコードを選ぶスクリプトです。`error.log`の、`ngx_mruby/`で始まり`mechanism enabled`を含む行を読む監視も影響を受けます。この値では、2.7.2から2.7.8を区別できません。どれも`2.7.1`を返すからです。
- 必要な対応：スクリプトや監視がこの値を`2.7.1`と比べているときは、`2.7.9`か、使っているリリースのバージョンと比べてください。2.7.2から2.7.8を区別するには、この値ではなく、モジュールをビルドしたリリースのタグかコミットを使ってください。

## 新機能

ありません。

## 不具合の修正

- `Nginx::Upstream#server`、`#server=`、`#keepalive_cache`、`#keepalive_cache=`と、`Nginx::Stream::Connection#upstream_server`、`#upstream_server=`は、`initialize`が例外を出したオブジェクト、`allocate`で作ったオブジェクト、`dup`か`clone`で作ったコピーで、`ArgumentError`を出すようになりました。これまでは、`nil`を返すか、NULLポインタを参照してworkerプロセスを終わらせていました(#816、#819)。
- `Nginx::Upstream.new`と`Nginx::Stream::Connection.new`は、upstreamに2つ以上のサーバーがあるために例外を出すとき、新しいオブジェクトのコンテキストのメモリを解放するようになりました。これまでは、そのような呼び出しのたびに、そのメモリがworkerが終了するまで確保されたままでした(#816)。

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

- 新しいテストケースとして、`test/t/cases/upstream_uninitialized.rb`と、ポート18093の`test/conf/conf.d/97-upstream-uninitialized.conf`のサーバーと、ポート12397の`test/conf/conf.d/stream/53-upstream-uninitialized.conf`のstreamのサーバーを加えました(#816)。
- `test/t/cases/upstream_uninitialized.rb`は、`.new`が返したオブジェクトの`dup`と`clone`によるコピーでも、既存のケースと同じHTTPとstreamのサーバーでupstreamのメソッドを呼び、`ArgumentError`が出ることを確かめるようになりました。元のオブジェクトがupstreamを持ち続けることも確かめます(#819)。
- `test/t/cases/argument_types.rb`がテストする`test/conf/conf.d/96-argument-types.conf`のサーバーを、ポート18200から、`next`と同じ18092に移しました。新しいテストのケースは、`master`と`next`のどちらでも使われていないポートを、HTTPでは18080から18199、streamでは12345から12399の範囲から選びます。`AGENTS.md`と`docs/test/README.md`に、この規則を書きました(#819)。
- テストのnginxの`worker_connections`(`test/conf/nginx.conf`)を、200から、`next`と同じ1024にしました。nginxは、listenしているソケットを1つずつworkerの接続として数えます。`master`のテストのnginxは、TCPの87個とUDPの2個を合わせた89個のソケットでlistenし、200で通ります。`next`のテストのnginxは125個のソケットでlistenし、valgrindの下では、`test/t/cases/_wait_for_listen.rb`が起動時に各ポートへ開く接続で、200の残りを使い切っていました。同じ値にしたので、この行は両方のブランチで同じになります(#819)。
- `test/t/cases/module_and_request.rb`は、`src/http/ngx_http_mruby_module.h`の`MODULE_VERSION`が、`docs/releases/vX.Y.Z.md`のファイルのうち最も新しいバージョンと同じであることを確かめます。バージョンは数として比べます。新しいバージョンのリリースのファイルを作るプルリクエストは、同じプルリクエストで`MODULE_VERSION`をそのバージョンにします。そうしないと、テストスイートが失敗します(#822)。

## アップグレード

- ディレクティブの追加、名前の変更、削除はありません。2.7.8と同じ方法でこのリリースのモジュールをビルドし、バイナリか動的モジュールを置き換えてください。`Nginx.module_version`は`2.7.9`を返します。

アップグレードの前に、次の点を確かめてください。各行は、各項目の「必要な対応」です。

- `initialize`が例外を出した後も、`Nginx::Upstream`か`Nginx::Stream::Connection`のオブジェクトを使い続けるスクリプトと、`dup`か`clone`で作ったコピーを使うスクリプト：オブジェクトは`.new`で作り、その呼び出しが例外を出したら使わないでください。コピーは使わず、`.new`でもう1つ作ってください。
- `Nginx.module_version`や、`error.log`の`ngx_mruby/`で始まり`mechanism enabled`を含む行を、`2.7.1`と比べるスクリプトと監視：`2.7.9`か、使っているリリースのバージョンと比べてください。2.7.2から2.7.8は、この値ではなく、リリースのタグかコミットで区別してください。
