こんにちは！Redisの世界へようこそ。
日々、データのやり取りに奮闘しているエンジニアの皆さん、お疲れ様です。
今回は、Redisの心臓部とも言える「Luaスクリプト（Redisの中で動く小さなプログラム）」と、そこからエラーを上手に伝えるための仕組み`redis.error_reply`について、徹底的に噛み砕いて解説していきますね。
「エラーを返すだけなのに、何がそんなに特別なのと？」と思ったそこのあなた。
ここをクリアすれば、あなたの書くRedisスクリプトの信頼性はプロのそれへと一気に引き上げられますよ。さあ、一緒に本質に迫っていきましょう！
—
1. 日常で例えるなら：「お店の店員さんと客のトラブル対応」
まずはイメージから入りましょう。
あなたは今、大人気のラーメン店の店長（Redis）です。そして、アルバイトの店員さん（Luaスクリプト）が、お客さん（クライアントアプリ）からの注文を代わりにさばいています。
ある日、お客さんが「塩ラーメンの大盛り、麺固め！」と注文してきました。しかし、今日の仕込みでは「塩ラーメンは普通盛りしか作れない」と決まっています。
この時、アルバイトの店員さんはどうするべきでしょうか？
1. 「かしこまりました！」と嘘をついて適当なものを出す（最悪のパターン：バグの温床）
2. お客さんに聞こえないように裏でこっそり首を振る（エラーが伝わらない）
3. お客さんに対してハッキリと、「申し訳ありません、塩ラーメンの大盛りは本日はご用意できません！」と伝える（正しいエラー応答）
RedisのLuaスクリプトの世界でもこれと全く同じことが起きます。プログラムが「おい、これ以上処理を続けられないぞ！」という異常事態に出くわしたとき、呼び出し元（クライアント）に正しく「ダメだよ！」と伝えるための専用の伝言板、それが `redis.error_reply` なのです。
—
2. `redis.error_reply` とは何か？（基本の仕組み）
Redisの中では、Luaスクリプトを使って複数のコマンドをまとめて実行（アトミックに実行）することができます。非常に便利なんですが、もしスクリプトの途中で「おっと、残高が足りない！」「入力された値がおかしいぞ！」と気づいたとき、どうやってRedisにエラーを教えればいいでしょうか？
昔の書き方（と言っても今でも動きますが）では、ただの文字列としてエラーを返したり、単純にLuaの `error()` 関数を使ってスクリプト全体を強制終了させたりしていました。
しかし、それだとRedis側が「おや、これはユーザー起因のエラーなのか、それともシステム内部のバグなのか」を綺麗に区別してクライアントに返すのが難しかったのです。
そこで登場したのが、`redis.error_reply` です。
これを使うと、Redisの通信プロトコル（RESP）の仕様に則った「ちゃんとしたエラーメッセージ」の形に包み込んで、呼び出し元にピシッと送り返すことができるようになります。
—
3. 実践！コードで見てみよう
百聞は一見にしかず。実際のコードを見てみましょう。
ここでは、「指定されたキーに、もし偶数だったら値を保存するが、奇数だったらエラーにする」という、ちょっと意地悪なスクリプトを書いてみます。
— KEYS[1]: 対象のキー
— ARGV[1]: チェックしたい数値
local key = KEYS[1]
local num = tonumber(ARGV[1])
— 数値かどうかをチェック
if not num then
— 数値じゃなければ、綺麗にエラーを返す！
return redis.error_reply(“ERR: 数値を入力してください。”)
end
— 奇数だったらエラーにする
if num % 2 ~= 0 then
— ここで登場するのが redis.error_reply です！
return redis.error_reply(“ERR: 偶数しか受け付けません！”)
end
— 偶数なら無事に保存
redis.call(“SET”, key, num)
return “OK: 正常に保存されました。”
このコードの何が素晴らしいのか？
もし、単にLuaの `error()` を使って文字を返すと、Redisのクライアント側では「なんだかよくわからないシステムクラッシュ（Script execution failed）」として受け取られてしまいます。
しかし、`redis.error_reply(“ERR: …”)` を使うことで、クライアント（Python, Node.js, Goなど）は、「あ、入力値のバリデーションエラーね。じゃあユーザーにもう一度入力を促そう」といった、アプリケーションレベルのエラーハンドリングを綺麗に実装できるようになるのです。
—
4. 先輩エンジニアからの実践知見（実務での使い所）
さて、基本的な使い方がわかったところで、一歩進んだ「プロの知見」をシェアしておきますね。
① エラーメッセージの頭には必ず `ERR` をつける
Redisのコミュニティにおける不文律として、カスタムエラーを返すときはメッセージの先頭に `ERR `（または大文字のエラーコード）を付けるのがお作法となっています。クライアントライブラリ側がエラーをパース（解析）しやすくなるためです。
- 良い例：`redis.error_reply(“ERR invalid_age_parameter”)`
- 悪い例：`redis.error_reply(“年齢がおかしいです”)`
② 「例外で落とすな、戻り値で語れ」
Luaスクリプト内で予期せぬバグ（ゼロ除算など）が起きたときはスクリプト全体がクラッシュしますが、ビジネスロジック上の弾き飛ばし（入力値チェックなど）は、必ず `redis.error_reply` で優しく拒絶するのが、可用性の高いシステムを作るコツです。
—
まとめ
お疲れ様でした！今回は `redis.error_reply` について、その役割と実務での重要性を紐解いてきました。
- `redis.error_reply` とは？
LuaスクリプトからRedis、そしてその先のクライアントへ「正しくエラーを伝えるための専用ヘルパー関数」である。
- なぜ使うのか？
システムエラーとアプリケーションのエラーを明確に切り分け、クライアント側でスマートなエラーハンドリング（例外処理）を行うため。
ここをしっかりと理解して使いこなせるようになれば、あなたの書くRedisスクリプトは、単なる「動くコード」から、現場で信頼される「堅牢なコード」へと生まれ変わります。
ここをクリアしたあなたなら、Redisの基本はもうバッチリマスターできていますよ！自信を持って次のステップへ進んでくださいね。
それでは、また次回のテックトークでお会いしましょう！
コメント