Bug: query params doesn't work?

[thompson0012]

Description

i am trying the litestar library for the api development. i found there are some stranges

doc: https://docs.litestar.dev/latest/usage/routing/parameters.html#query-parameters

from litestar import Litestar, get


@get("/", sync_to_thread=False)
def index(param: str) -> dict[str, str]:
    return {"param": param}


app = Litestar(route_handlers=[index])

> curl http://127.0.0.1:8000/?param=foo
{"param":"foo"}
> curl http://127.0.0.1:8000/?param=bar
{"param":"bar"}

but the terminal show me when i follow the instruction

zsh: no matches found: http://localhost:8000?param=uiyhkjh

when i remove the query param, it showed

{"status_code":400,"detail":"Missing required query parameter 'param' for url http://localhost:8000/"}%      

i have no idea on the issue, i just simply follow the guidelines, without any modification

URL to code causing the issue

No response

MCVE

# Your MCVE code here

Steps to reproduce

1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error

Screenshots

"![SCREENSHOT_DESCRIPTION](SCREENSHOT_LINK.png)"

Logs

No response

Litestar Version

Version(major=2, minor=4, patch=1, release_level='final', serial=0)

Platform

• Linux
• Mac
• Windows
• Other (Please specify in the description above)

---

Note

While we are open for sponsoring on GitHub Sponsors and
OpenCollective, we also utilize Polar.sh to engage in pledge-based sponsorship.

Check out all issues funded or available for funding on our Polar.sh Litestar dashboard

• If you would like to see an issue prioritized, make a pledge towards it!
• We receive the pledge once the issue is completed & verified
• This, along with engagement in the community, helps us know which features are a priority to our users.

[provinzkraut]

but the terminal show me when i follow the instruction

It's not clear what you are doing here. Where does it show that? What instruction are you following?

The curl command you're running seems to work fine from the output?

[thompson0012]

i am trying to repeat the steps from the guideline.

i simply copy and paste the command

from litestar import Litestar, get


@get("/", sync_to_thread=False)
def index(param: str) -> dict[str, str]:
    return {"param": param}


app = Litestar(route_handlers=[index])

and execute it in shell

> curl http://localhost:8000?param=uiyhkjh

but the curl resulted in the following

zsh: no matches found: http://localhost:8000?param=uiyhkjh

[thompson0012]

[provinzkraut]

The error message is coming from zsh, not Litestar. You need to either escape the ? or surround the whole string in quotes.

curl "http://localhost:8000?param=uiyhkjh"

[thompson0012]

ok, got it. thanks!