parse-community / parse-community/parse-server
/installations and /audiences reject a find sent as POST + _method=GET with "Invalid key name: 0"
Nobody has claimed this yet.
- Dominant language
- JavaScript
- Stars
- 21.4k
- Forks
- 4.8k
- Avg merge
- 7h 45m
- Merged PRs (30d)
- 11
Description
New Issue Checklist
- Report security issues confidentially.
- Any contribution is under this license.
- Before posting search existing issues.
Issue Description
InstallationsRouter.handleFind and AudiencesRouter.handleFind override ClassesRouter.handleFind but drop its string-where decoding step, so a query sent with the documented POST + _method=GET override fails on /installations and /audiences while the identical query succeeds on /classes/_Installation.
ClassesRouter.handleFind decodes a where that arrives in the request body as a JSON string:
if (typeof body.where === 'string') {
try {
body.where = JSON.parse(body.where);
} catch {
throw new Parse.Error(Parse.Error.INVALID_JSON, 'where parameter is not valid JSON');
}
}
The two subclasses copy the body/options lines but not that block, so they only handle a where that arrives in the query string (decoded by ClassesRouter.JSONFromQuery). When the client uses the method override with an application/x-www-form-urlencoded body, body.where stays a string and is passed straight to rest.find. DatabaseController.validateQuery then runs Object.keys() over the string, walking it character by character, and the first index fails the key-name regex:
{"code":105,"error":"Invalid key name: 0"}
This is the same failure mode as the AggregateRouter pipeline handling that produced Invalid aggregate stage '0'.
The trigger is query size, not query shape. SDKs switch from GET to POST + _method=GET once the URL exceeds ~2 KB, so this only appears when an app queries /installations with a large enough constraint, for example an installationId $in list of roughly 41 or more ids. The same code path works for /users, /roles and /sessions, whose routers inherit ClassesRouter.handleFind unchanged.
Steps to reproduce
Any query long enough for the SDK to use the method override reproduces this. A minimal equivalent with curl:
# 1. POST + _method=GET against /installations -> error 105
curl -s -X POST \
-H 'X-Parse-Application-Id: myAppId' \
-H 'X-Parse-Master-Key: myMasterKey' \
-H 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode '_method=GET' \
--data-urlencode 'where={"installationId":{"$in":["af593bd0-cede-4b27-b0d0-1b48a025dc03"]}}' \
--data-urlencode 'limit=100' \
http://localhost:1337/parse/installations
# 2. Identical request against /classes/_Installation -> succeeds
curl -s -X POST \
-H 'X-Parse-Application-Id: myAppId' \
-H 'X-Parse-Master-Key: myMasterKey' \
-H 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode '_method=GET' \
--data-urlencode 'where={"installationId":{"$in":["af593bd0-cede-4b27-b0d0-1b48a025dc03"]}}' \
--data-urlencode 'limit=100' \
http://localhost:1337/parse/classes/_Installation
# 3. Same where as a GET query string against /installations -> succeeds
curl -s -G \
-H 'X-Parse-Application-Id: myAppId' \
-H 'X-Parse-Master-Key: myMasterKey' \
--data-urlencode 'where={"installationId":{"$in":["af593bd0-cede-4b27-b0d0-1b48a025dc03"]}}' \
http://localhost:1337/parse/installations
/audiences fails the same way.
Actual Outcome
1. {"code":105,"error":"Invalid key name: 0"}
2. {"results":[]}
3. {"results":[]}
Expected Outcome
All three return the query results. The method override is supported transport for a find, so /installations and /audiences should decode a string where from the body exactly as /classes/:className does.
Environment
Server
- Parse Server version:
9.10.0(also present onalphaat9.10.1-alpha.6;src/Routers/InstallationsRouter.jsandsrc/Routers/AudiencesRouter.jsare unchanged there) - Operating system:
macOS 15.5 (Docker, node:22 image) - Local or remote host:
local
Database
- System (MongoDB or Postgres):
MongoDB - Database version:
7.0.31 - Local or remote host:
local
Client
- SDK (iOS, Android, JavaScript, PHP, Unity, etc):
reproduced with curl; originally hit from the Ruby SDK - SDK version:
parse-stack-next 5.7.0
Logs
error: Invalid key name: 0 {"code":105,"stack":"Error: Invalid key name: 0
at .../parse-server/lib/Controllers/DatabaseController.js:208:13
at Array.forEach (<anonymous>)
at validateQuery (.../parse-server/lib/Controllers/DatabaseController.js:190:22)
at .../parse-server/lib/Controllers/DatabaseController.js:1238:11
at async _UnsafeRestQuery.runFind (.../parse-server/lib/RestQuery.js:785:19)"}
{"method":"POST","objectId":null,"body":{"keys":"installationId,appBuildNumber,appVersion","limit":"100","skip":"0","where":"{\"installationId\":{\"$in\":[\"af593bd0-cede-4b27-b0d0-1b48a025dc03\", ...]}}"},"installationId":null,"statusCode":400}
The logged body.where is still a string at the point the error is raised, which is the tell: ClassesRouter.handleFind mutates req.body.where into an object in place, so a request that went through the classes route would show a decoded object here.
I have a fix and can open a PR against alpha.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by comparing src/Routers/InstallationsRouter.js and src/Routers/AudiencesRouter.js with ClassesRouter.handleFind, focusing on how a string where value from the request body is handled. Use the curl method-override reproducer against both routes and confirm that the requests return query results instead of Invalid key name: 0.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- javascript, nodejs
- Domain
- api, backend
- Issue type
- Bug
- Difficulty
- 2/5
- Estimated time
- Half a day
- Activity status
- Quiet
- Clarity
- Clearly specified
- Newbie friendliness
- 65/100