SQSをローカルでテストする互換シミュレーター「lqs」を公開した

Sat, 19 Sep 2026 20:05:53 +0900

SQSをローカルでテストするための互換シミュレーター、 lqs を公開した。名前は local queue service の略。

AWS SDKから接続できるHTTP APIを用意していて、StandardキューとFIFOキューの送受信や、可視性タイムアウト、DLQへの移動などを手元で試せる。

一旦、用意していたissueが全部片付いたので公開することにした。

SQSをローカルで試したかった

SQSを使うアプリケーションを書いていると、キューへ送ったメッセージをワーカーが受け取るところまで、ローカルで動かしたくなる。

単に送信と受信が成功するだけでなく、処理中にワーカーが落ちたらどうなるか、同じメッセージを再送したらどうなるかも確認したい。そのたびにAWS上のキューを用意するのも少し面倒だった。

ローカルでSQSを使うためのものは既にあって、 LocalStack や ElasticMQ がある。

LocalStackはSQSを含む複数のAWSサービスをローカルで扱う環境で、ElasticMQはSQS互換インターフェースを持つメッセージキュー。SQSのエミュレーターを探すと、このあたりが出てくる。

自分でも、SQSを使う処理の開発・テストに使えるものを作ってみたくなった。そこから作り始めたのがlqsになる。

lqsはローカルでHTTPサーバーとして起動する。アプリケーション側では、SQSクライアントの接続先をlqsへ向けて使う。

既定の接続先はhttp://127.0.0.1:9324。

キューの作成、メッセージの送信・受信・削除といった操作をHTTP APIから実行できる。JSON形式とSQS Query形式の両方に対応している。

実際にAWS SDK for Go v2からサーバーへ接続する結合テストも用意した。送受信だけでなく、FIFOやDLQ、エラー応答なども確認している。

署名の検証は行わないので、SDKに設定する認証情報はローカル用のダミー値でよい。テストではアクセスキーとシークレットにそれぞれtest、リージョンにus-east-1を指定している。

主な対応機能はこんな感じ。

機能	試せること
Standard / FIFO	メッセージの送受信、FIFOのグループ内の順序制御
可視性タイムアウト	受信後の一時的な非表示、期限切れ後の再受信、期限の変更
FIFOの重複排除	IDや本文を使った送信の重複排除
ロングポーリング	メッセージの到着を待って受信
DLQ	受信回数の上限に達したメッセージの移動
遅延・保持期限	すぐに配信しないメッセージや、期限切れの扱い
バッチ操作	複数メッセージの送信・削除・可視性変更
属性・キュー管理	メッセージ属性、キュー設定、一覧、タグ、パージなど

キューの設定やメッセージはローカルに保存できるので、再起動して続きを確認することもできる。

キューから受信しただけでは、メッセージは削除されない。処理が終わってから削除する。

途中でワーカーが落ちて削除できなかった場合は、可視性タイムアウトが切れると再び受信できる。この動きをローカルでも試せるようにした。

何度やっても処理できないメッセージは、設定した受信回数の上限に達したあと、再び受信対象になるタイミングでDLQへ移す。

正常なメッセージだけを流していると気づかないこともあるので、こういう失敗側の動きを試せるのは欲しかったところ。

FIFOでは、同じグループのメッセージの順序を維持しながら、別のグループの処理を進められる。

例えば注文ごとにグループを分ければ、同じ注文のイベントを順に処理しつつ、別の注文も扱える。

送信の重複排除もあり、5分間の重複排除期間内に同じIDで再送しても、新しいメッセージを追加しない。本文から重複を判定する設定も使える。