できない.dev

Express 5「Cannot set property query ... which has only a getter」の原因と直し方

Cannot set property query of #<IncomingMessage> which has only a getter は、Express 5 で req.query に代入するミドルウェアが出す。
その前で req.query を書き込めるプロパティに置き換えれば直る。

公開:

症状できない · exit 22
curl -s --fail-with-body -g 'http://localhost:3000/users?name[$ne]=x'
{"error":"TypeError: Cannot set property query of #<IncomingMessage> which has only a getter"}
解決後できた · exit 0
curl -s --fail-with-body -g 'http://localhost:3000/users?name[$ne]=x'
{"name[$ne]":"x"}

2026-11-07 に node:24(Express 5.3.0 / Node.js 24.22.2) で実際に打って取った出力。検証環境の詳細

要約

Express 5 に上げると、app.use(mongoSanitize()) のようなミドルウェアを通るリクエストがすべて 500 になり、サーバーのログに次の例外が出る。

TypeError: Cannot set property query of #<IncomingMessage> which has only a getter

5 の req.query は、読むたびに URL のクエリを解析し直す読み取り専用のプロパティ(getter)になった(移行ガイド(新しいタブで開く)の「req.query」)。
4 では req.query に代入できたので、値を作り直して代入し直すミドルウェアがあった。
strict モードのコードが setter の無いプロパティに代入すると、JavaScript は TypeError を投げる。

そのミドルウェアの前で req.query を普通のプロパティに置き換えるか、req.query に代入しない書き方に替えれば直る。

実行例

node:24 のコンテナで Express 5.3.0 に express-mongo-sanitize と xss-clean を入れると、GET も POST も 500 になった(--fail-with-body は 400 以上の応答で本文を出す)。
req.query を置き換えるミドルウェアを前に足すと、同じ curl が 0 で通った。

$ npm ls express express-mongo-sanitize xss-clean
tmp.ecayjuotia@1.0.0 /tmp/tmp.ecayJUOTiA
+-- express-mongo-sanitize@2.2.0
+-- express@5.3.0
`-- xss-clean@0.1.4
$ cat app.js
const express = require("express");
const mongoSanitize = require("express-mongo-sanitize");
const xss = require("xss-clean");
const app = express();
 
app.use(express.json());
app.use(mongoSanitize()); // $ で始まるキーを取り除く
app.use(xss()); // < と > を書き換える
 
app.get("/users", (req, res) => res.json(req.query));
app.post("/users", (req, res) => res.json(req.body));
 
app.use((err, req, res, next) => {
  console.error(err.stack);
  res.status(500).json({ error: String(err) });
});
 
app.listen(3000, () => console.log("listening on 3000"));
$ node app.js > server.log 2>&1 &
$ curl -s --fail-with-body -g 'http://localhost:3000/users?name[$ne]=x'
{"error":"TypeError: Cannot set property query of #<IncomingMessage> which has only a getter"}
$ echo $?
22
$ curl -s --fail-with-body -X POST -H "Content-Type: application/json" -d '{"name":{"$ne":"x"}}' http://localhost:3000/users
{"error":"TypeError: Cannot set property query of #<IncomingMessage> which has only a getter"}
$ echo $?
22
$ head -n 3 server.log
listening on 3000
TypeError: Cannot set property query of #<IncomingMessage> which has only a getter
    at /tmp/tmp.ecayJUOTiA/node_modules/express-mongo-sanitize/index.js:113:18
$ cat app.js
const express = require("express");
const mongoSanitize = require("express-mongo-sanitize");
const xss = require("xss-clean");
const app = express();
 
app.use(express.json());
// Express 5 の req.query は getter なので、値を持つ普通のプロパティに置き換える
app.use((req, res, next) => {
  Object.defineProperty(req, "query", {
    value: req.query,
    writable: true,
    enumerable: true,
    configurable: true,
  });
  next();
});
app.use(mongoSanitize());
app.use(xss());
 
app.get("/users", (req, res) => res.json(req.query));
app.post("/users", (req, res) => res.json(req.body));
 
app.use((err, req, res, next) => {
  console.error(err.stack);
  res.status(500).json({ error: String(err) });
});
 
app.listen(3000, () => console.log("listening on 3000"));
$ node app.js > server.log 2>&1 &
$ curl -s --fail-with-body -g 'http://localhost:3000/users?name[$ne]=x'
{"name[$ne]":"x"}
$ echo $?
0
$ curl -s --fail-with-body -X POST -H "Content-Type: application/json" -d '{"name":{"$ne":"x"}}' http://localhost:3000/users
{"name":{}}
$ echo $?
0
$ curl -s --fail-with-body -g "http://localhost:3000/users?q=<b>hi</b>"
{"q":"&lt;b>hi&lt;/b>"}
$ echo $?
0
$ cat app.js
const express = require("express");
const mongoSanitize = require("express-mongo-sanitize");
const app = express();
 
app.use(express.json());
app.use((req, res, next) => {
  if (req.body) mongoSanitize.sanitize(req.body);
  next();
});
 
app.get("/users", (req, res) => res.json(req.query));
app.post("/users", (req, res) => res.json(req.body));
 
app.use((err, req, res, next) => {
  console.error(err.stack);
  res.status(500).json({ error: String(err) });
});
 
app.listen(3000, () => console.log("listening on 3000"));
$ node app.js > server.log 2>&1 &
$ curl -s --fail-with-body -g 'http://localhost:3000/users?name[$ne]=x'
{"name[$ne]":"x"}
$ echo $?
0
$ curl -s --fail-with-body -X POST -H "Content-Type: application/json" -d '{"name":{"$ne":"x"}}' http://localhost:3000/users
{"name":{}}
$ echo $?
0

— 2026-11-07 時点の出力

検証環境Node.js 24.22.2 / npm 11.19.1 / Python 3.11.2 / 2026-11-07 検証(ほか 2 件)
検証日
実行環境
node:24 Debian GNU/Linux 12 (bookworm)
バージョン
  • Node.js 24.22.2
  • npm 11.19.1
  • Python 3.11.2
  • Git 2.39.5
  • Express 5.3.0

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. req.query を書き込めるプロパティに置き換える

古いミドルウェアより前に、次のミドルウェアを置く。

app.use((req, res, next) => {
  Object.defineProperty(req, "query", {
    value: req.query,
    writable: true,
    enumerable: true,
    configurable: true,
  });
  next();
});
app.use(mongoSanitize());
app.use(xss());

getter は req のプロトタイプにあり、Object.defineProperty() はそれより先に見つかる値を req 自身に置く。
後ろのミドルウェアの代入はこの値を書き換えるので、express-mongo-sanitize も xss-clean も 4 と同じように動く。
5 の既定のクエリのパーサーは name[$ne]=x を入れ子にせず、name[$ne] という名前の文字列のまま渡すので、MongoDB の演算子にはならない。

2. req.body だけをその場で書き換える

express-mongo-sanitize の sanitize() は、渡したオブジェクトから $ で始まるキーをその場で取り除き、同じオブジェクトを返す。
ミドルウェアとして登録せず、req.body に対して呼ぶ。

app.use((req, res, next) => {
  if (req.body) mongoSanitize.sanitize(req.body);
  next();
});

app.set("query parser", "extended") でクエリを入れ子に読むアプリでは、読む側で mongoSanitize.sanitize(req.query) の戻り値を使う。

3. 自分のコードでは req.query に代入しない

直した値は res.locals.query のような別の場所に入れ、後ろのハンドラーはそこから読む。

4. 書き換えが済むまで 4 に戻す

npm install express@4

4.22.3 では、どちらのミドルウェアもそのまま動いた。

よくある原因

  1. req.query に代入し直すミドルウェアを使っている。
    2026-11-07 時点で最新の express-mongo-sanitize 2.2.0 と xss-clean 0.1.4 が当てはまり、req.body しか読まない POST も 500 になる。
    hpp 0.2.3 は例外を出さないが、書き換えた req.query が次に読むと元に戻るので、5 では効いていない。
  2. 自分のミドルウェアで req.query = ... と代入している。
    ES モジュールや "use strict" を書いたファイルでは同じ TypeError になる。
    それ以外のファイルでは例外にならず、代入が黙って捨てられる。

代入したミドルウェアは、ログの TypeError の次の行(最初の at)に出るファイルで分かる。