{"id":132,"date":"2026-06-15T14:14:53","date_gmt":"2026-06-15T06:14:53","guid":{"rendered":"https:\/\/www.52runoob.com\/?p=132"},"modified":"2026-06-15T14:14:53","modified_gmt":"2026-06-15T06:14:53","slug":"fastapi-%e6%9f%a5%e8%af%a2%e5%8f%82%e6%95%b0","status":"publish","type":"post","link":"https:\/\/www.52runoob.com\/index.php\/2026\/06\/15\/fastapi-%e6%9f%a5%e8%af%a2%e5%8f%82%e6%95%b0\/","title":{"rendered":"FastAPI \u67e5\u8be2\u53c2\u6570"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">\u5728 FastAPI \u4e2d\uff0c<strong>\u67e5\u8be2\u53c2\u6570\uff08Query Parameters\uff09<\/strong> \u662f URL \u4e2d <code>?<\/code> \u540e\u9762\u7684\u952e\u503c\u5bf9\uff0c\u591a\u4e2a\u53c2\u6570\u4e4b\u95f4\u7528 <code>&amp;<\/code> \u5206\u9694\uff08\u4f8b\u5982\uff1a<code>\/items?skip=0&amp;limit=10<\/code>\uff09\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">FastAPI \u7684\u6838\u5fc3\u9b54\u6cd5\u5728\u4e8e\uff1a<strong>\u4efb\u4f55\u672a\u5728\u8def\u5f84\uff08Path\uff09\u4e2d\u58f0\u660e\u7684\u51fd\u6570\u53c2\u6570\uff0c\u90fd\u4f1a\u88ab\u81ea\u52a8\u89c6\u4e3a\u67e5\u8be2\u53c2\u6570<\/strong>\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u4ee5\u4e0b\u662f FastAPI \u67e5\u8be2\u53c2\u6570\u7684\u6838\u5fc3\u7528\u6cd5\u548c\u8fdb\u9636\u6280\u5de7\uff1a<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">1. \u57fa\u672c\u7528\u6cd5<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u76f4\u63a5\u5728\u51fd\u6570\u7b7e\u540d\u4e2d\u58f0\u660e\u53c2\u6570\u5373\u53ef\u3002FastAPI \u4f1a\u81ea\u52a8\u4ece URL \u7684\u67e5\u8be2\u5b57\u7b26\u4e32\u4e2d\u63d0\u53d6\u5e76\u8f6c\u6362\u7c7b\u578b\u3002<\/p>\n\n\n\n<div class=\"chp-code-block chp-theme-github-dark chp-wrap-on\" data-chp-language=\"plaintext\" data-chp-line-start=\"1\" data-chp-highlight=\"\"><div class=\"chp-toolbar\"><div class=\"chp-toolbar-left\"><span class=\"chp-dots\"><span><\/span><span><\/span><span><\/span><\/span><span class=\"chp-language-label\">\u7eaf\u6587\u672c<\/span><\/div><div class=\"chp-toolbar-right\"><button type=\"button\" class=\"chp-copy-btn\" aria-label=\"\u590d\u5236\u4ee3\u7801\"><svg class=\"chp-icon-copy\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\"><path fill=\"currentColor\" d=\"M16 1H4c-1.1 0-2 .9-2 2v14h2V3h12V1zm3 4H8c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h11c1.1 0 2-.9 2-2V7c0-1.1-.9-2-2-2zm0 16H8V7h11v14z\"\/><\/svg><svg class=\"chp-icon-check\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\" style=\"display:none;\"><path fill=\"currentColor\" d=\"M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z\"\/><\/svg><span class=\"chp-copy-text\">\u590d\u5236<\/span><\/button><\/div><\/div><div class=\"chp-code-wrapper\"><div class=\"chp-line-numbers\" aria-hidden=\"true\"><span>1<\/span><span>2<\/span><span>3<\/span><span>4<\/span><span>5<\/span><span>6<\/span><span>7<\/span><\/div><pre class=\"chp-pre\" style=\"font-size:14px;\"><code class=\"language-plaintext\">from fastapi import FastAPI\n\napp = FastAPI()\n\n@app.get(&quot;\/items\/&quot;)\nasync def read_items(skip: int = 0, limit: int = 10):\n    return {&quot;skip&quot;: skip, &quot;limit&quot;: limit}<\/code><\/pre><\/div><\/div>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u8bbf\u95ee <code>\/items\/<\/code>\uff1a\u8fd4\u56de <code>{\"skip\": 0, \"limit\": 10}<\/code><\/li>\n\n\n\n<li>\u8bbf\u95ee <code>\/items\/?skip=20&amp;limit=5<\/code>\uff1a\u8fd4\u56de <code>{\"skip\": 20, \"limit\": 5}<\/code><\/li>\n\n\n\n<li>\u8bbf\u95ee <code>\/items\/?skip=foo<\/code>\uff1a\u8fd4\u56de <strong>422 \u9519\u8bef<\/strong>\uff0c\u56e0\u4e3a <code>foo<\/code> \u65e0\u6cd5\u8f6c\u6362\u4e3a <code>int<\/code>\u3002<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">2. \u53ef\u9009\u67e5\u8be2\u53c2\u6570 (Optional)<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u5982\u679c\u4f60\u5e0c\u671b\u67d0\u4e2a\u67e5\u8be2\u53c2\u6570\u662f\u53ef\u9009\u7684\uff0c\u53ea\u9700\u4e3a\u5176\u63d0\u4f9b\u4e00\u4e2a\u9ed8\u8ba4\u503c\uff08\u901a\u5e38\u662f <code>None<\/code> \u6216\u67d0\u4e2a\u5177\u4f53\u503c\uff09\u3002<\/p>\n\n\n\n<div class=\"chp-code-block chp-theme-github-dark chp-wrap-on\" data-chp-language=\"plaintext\" data-chp-line-start=\"1\" data-chp-highlight=\"\"><div class=\"chp-toolbar\"><div class=\"chp-toolbar-left\"><span class=\"chp-dots\"><span><\/span><span><\/span><span><\/span><\/span><span class=\"chp-language-label\">\u7eaf\u6587\u672c<\/span><\/div><div class=\"chp-toolbar-right\"><button type=\"button\" class=\"chp-copy-btn\" aria-label=\"\u590d\u5236\u4ee3\u7801\"><svg class=\"chp-icon-copy\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\"><path fill=\"currentColor\" d=\"M16 1H4c-1.1 0-2 .9-2 2v14h2V3h12V1zm3 4H8c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h11c1.1 0 2-.9 2-2V7c0-1.1-.9-2-2-2zm0 16H8V7h11v14z\"\/><\/svg><svg class=\"chp-icon-check\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\" style=\"display:none;\"><path fill=\"currentColor\" d=\"M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z\"\/><\/svg><span class=\"chp-copy-text\">\u590d\u5236<\/span><\/button><\/div><\/div><div class=\"chp-code-wrapper\"><div class=\"chp-line-numbers\" aria-hidden=\"true\"><span>1<\/span><span>2<\/span><span>3<\/span><span>4<\/span><span>5<\/span><span>6<\/span><span>7<\/span><\/div><pre class=\"chp-pre\" style=\"font-size:14px;\"><code class=\"language-plaintext\">from typing import Optional # Python 3.10+ \u53ef\u76f4\u63a5\u7528 str | None\n\n@app.get(&quot;\/items\/&quot;)\nasync def read_items(q: str | None = None):\n    if q:\n        return {&quot;items&quot;: [{&quot;name&quot;: &quot;Item Foo&quot;}, {&quot;name&quot;: &quot;Item Bar&quot;}], &quot;q&quot;: q}\n    return {&quot;items&quot;: [{&quot;name&quot;: &quot;Item Foo&quot;}, {&quot;name&quot;: &quot;Item Bar&quot;}]}<\/code><\/pre><\/div><\/div>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u8bbf\u95ee <code>\/items\/<\/code>\uff1a<code>q<\/code> \u4e3a <code>None<\/code>\u3002<\/li>\n\n\n\n<li>\u8bbf\u95ee <code>\/items\/?q=somequery<\/code>\uff1a<code>q<\/code> \u4e3a <code>\"somequery\"<\/code>\u3002<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">3. \u4f7f\u7528 <code>Query<\/code> \u6dfb\u52a0\u9ad8\u7ea7\u9a8c\u8bc1<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u4f60\u53ef\u4ee5\u4ece <code>fastapi<\/code> \u5bfc\u5165 <code>Query<\/code>\uff0c\u4e3a\u67e5\u8be2\u53c2\u6570\u6dfb\u52a0\u66f4\u4e25\u683c\u7684\u9a8c\u8bc1\u89c4\u5219\uff08\u5982\u957f\u5ea6\u9650\u5236\u3001\u6b63\u5219\u8868\u8fbe\u5f0f\u3001\u662f\u5426\u5e9f\u5f03\u7b49\uff09\u3002<\/p>\n\n\n\n<div class=\"chp-code-block chp-theme-github-dark chp-wrap-on\" data-chp-language=\"plaintext\" data-chp-line-start=\"1\" data-chp-highlight=\"\"><div class=\"chp-toolbar\"><div class=\"chp-toolbar-left\"><span class=\"chp-dots\"><span><\/span><span><\/span><span><\/span><\/span><span class=\"chp-language-label\">\u7eaf\u6587\u672c<\/span><\/div><div class=\"chp-toolbar-right\"><button type=\"button\" class=\"chp-copy-btn\" aria-label=\"\u590d\u5236\u4ee3\u7801\"><svg class=\"chp-icon-copy\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\"><path fill=\"currentColor\" d=\"M16 1H4c-1.1 0-2 .9-2 2v14h2V3h12V1zm3 4H8c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h11c1.1 0 2-.9 2-2V7c0-1.1-.9-2-2-2zm0 16H8V7h11v14z\"\/><\/svg><svg class=\"chp-icon-check\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\" style=\"display:none;\"><path fill=\"currentColor\" d=\"M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z\"\/><\/svg><span class=\"chp-copy-text\">\u590d\u5236<\/span><\/button><\/div><\/div><div class=\"chp-code-wrapper\"><div class=\"chp-line-numbers\" aria-hidden=\"true\"><span>1<\/span><span>2<\/span><span>3<\/span><span>4<\/span><span>5<\/span><span>6<\/span><span>7<\/span><span>8<\/span><span>9<\/span><span>10<\/span><span>11<\/span><span>12<\/span><span>13<\/span><span>14<\/span><span>15<\/span><span>16<\/span><span>17<\/span><\/div><pre class=\"chp-pre\" style=\"font-size:14px;\"><code class=\"language-plaintext\">from fastapi import FastAPI, Query\n\napp = FastAPI()\n\n# \u4f20\u7edf\u5199\u6cd5\n@app.get(&quot;\/items\/&quot;)\nasync def read_items(\n    q: str | None = Query(\n        default=None, \n        title=&quot;Search query&quot;,\n        description=&quot;Query string to search for items&quot;,\n        min_length=3,\n        max_length=50,\n        regex=&quot;^fixedquery$&quot; # \u53ea\u5141\u8bb8\u7cbe\u786e\u5339\u914d &quot;fixedquery&quot;\n    )\n):\n    return {&quot;q&quot;: q}<\/code><\/pre><\/div><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">\u5982\u679c\u4f20\u5165\u7684 <code>q<\/code> \u957f\u5ea6\u5c0f\u4e8e 3 \u6216\u4e0d\u7b26\u5408\u6b63\u5219\uff0cFastAPI \u4f1a\u81ea\u52a8\u8fd4\u56de\u6e05\u6670\u7684 422 \u9a8c\u8bc1\u9519\u8bef\u3002<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">4. \u73b0\u4ee3\u63a8\u8350\u5199\u6cd5\uff1a\u4f7f\u7528 <code>Annotated<\/code> (Python 3.9+)<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">FastAPI \u5b98\u65b9\u5f3a\u70c8\u63a8\u8350\u4f7f\u7528 <code>typing.Annotated<\/code>\u3002\u5b83\u5c06\u7c7b\u578b\u548c\u5143\u6570\u636e\uff08\u5982 <code>Query<\/code>\uff09\u5206\u79bb\uff0c\u4f7f\u4ee3\u7801\u66f4\u6e05\u6670\uff0c\u4e14\u5bf9\u7c7b\u578b\u68c0\u67e5\u5668\uff08\u5982 mypy\uff09\u66f4\u53cb\u597d\u3002<\/p>\n\n\n\n<div class=\"chp-code-block chp-theme-github-dark chp-wrap-on\" data-chp-language=\"plaintext\" data-chp-line-start=\"1\" data-chp-highlight=\"\"><div class=\"chp-toolbar\"><div class=\"chp-toolbar-left\"><span class=\"chp-dots\"><span><\/span><span><\/span><span><\/span><\/span><span class=\"chp-language-label\">\u7eaf\u6587\u672c<\/span><\/div><div class=\"chp-toolbar-right\"><button type=\"button\" class=\"chp-copy-btn\" aria-label=\"\u590d\u5236\u4ee3\u7801\"><svg class=\"chp-icon-copy\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\"><path fill=\"currentColor\" d=\"M16 1H4c-1.1 0-2 .9-2 2v14h2V3h12V1zm3 4H8c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h11c1.1 0 2-.9 2-2V7c0-1.1-.9-2-2-2zm0 16H8V7h11v14z\"\/><\/svg><svg class=\"chp-icon-check\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\" style=\"display:none;\"><path fill=\"currentColor\" d=\"M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z\"\/><\/svg><span class=\"chp-copy-text\">\u590d\u5236<\/span><\/button><\/div><\/div><div class=\"chp-code-wrapper\"><div class=\"chp-line-numbers\" aria-hidden=\"true\"><span>1<\/span><span>2<\/span><span>3<\/span><span>4<\/span><span>5<\/span><span>6<\/span><span>7<\/span><span>8<\/span><span>9<\/span><span>10<\/span><span>11<\/span><\/div><pre class=\"chp-pre\" style=\"font-size:14px;\"><code class=\"language-plaintext\">from typing import Annotated\nfrom fastapi import FastAPI, Query\n\napp = FastAPI()\n\n@app.get(&quot;\/items\/&quot;)\nasync def read_items(\n    # \u7c7b\u578b\u63d0\u793a\u5728\u524d\uff0cQuery \u9a8c\u8bc1\u89c4\u5219\u5728\u540e\uff0c\u9ed8\u8ba4\u503c\u653e\u5728\u6700\u540e\n    q: Annotated[str | None, Query(min_length=3, max_length=50, description=&quot;Search query&quot;)] = None\n):\n    return {&quot;q&quot;: q}<\/code><\/pre><\/div><\/div>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">5. \u58f0\u660e\u201c\u5fc5\u9700\u201d\u7684\u67e5\u8be2\u53c2\u6570<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u5982\u679c\u67d0\u4e2a\u67e5\u8be2\u53c2\u6570\u662f<strong>\u5fc5\u987b\u63d0\u4f9b<\/strong>\u7684\uff08\u6ca1\u6709\u9ed8\u8ba4\u503c\uff09\uff0c\u4f60\u53ef\u4ee5\u4f7f\u7528 <code>...<\/code> (Ellipsis) \u4f5c\u4e3a\u9ed8\u8ba4\u503c\uff0c\u6216\u8005\u5728 <code>Annotated<\/code> \u4e2d\u4e0d\u63d0\u4f9b\u9ed8\u8ba4\u503c\u3002<\/p>\n\n\n\n<div class=\"chp-code-block chp-theme-github-dark chp-wrap-on\" data-chp-language=\"plaintext\" data-chp-line-start=\"1\" data-chp-highlight=\"\"><div class=\"chp-toolbar\"><div class=\"chp-toolbar-left\"><span class=\"chp-dots\"><span><\/span><span><\/span><span><\/span><\/span><span class=\"chp-language-label\">\u7eaf\u6587\u672c<\/span><\/div><div class=\"chp-toolbar-right\"><button type=\"button\" class=\"chp-copy-btn\" aria-label=\"\u590d\u5236\u4ee3\u7801\"><svg class=\"chp-icon-copy\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\"><path fill=\"currentColor\" d=\"M16 1H4c-1.1 0-2 .9-2 2v14h2V3h12V1zm3 4H8c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h11c1.1 0 2-.9 2-2V7c0-1.1-.9-2-2-2zm0 16H8V7h11v14z\"\/><\/svg><svg class=\"chp-icon-check\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\" style=\"display:none;\"><path fill=\"currentColor\" d=\"M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z\"\/><\/svg><span class=\"chp-copy-text\">\u590d\u5236<\/span><\/button><\/div><\/div><div class=\"chp-code-wrapper\"><div class=\"chp-line-numbers\" aria-hidden=\"true\"><span>1<\/span><span>2<\/span><span>3<\/span><span>4<\/span><span>5<\/span><span>6<\/span><span>7<\/span><span>8<\/span><span>9<\/span><span>10<\/span><span>11<\/span><span>12<\/span><span>13<\/span><\/div><pre class=\"chp-pre\" style=\"font-size:14px;\"><code class=\"language-plaintext\">from fastapi import Query\n\n# \u4f20\u7edf\u5199\u6cd5\uff1a\u4f7f\u7528 ... \u8868\u793a\u5fc5\u9700\n@app.get(&quot;\/items\/&quot;)\nasync def read_items(q: str = Query(..., min_length=3)):\n    return {&quot;q&quot;: q}\n\n# \u73b0\u4ee3 Annotated \u5199\u6cd5\uff1a\u76f4\u63a5\u4e0d\u7ed9\u9ed8\u8ba4\u503c\n@app.get(&quot;\/items\/&quot;)\nasync def read_items_modern(\n    q: Annotated[str, Query(min_length=3)]\n):\n    return {&quot;q&quot;: q}<\/code><\/pre><\/div><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">\u6b64\u65f6\u8bbf\u95ee <code>\/items\/<\/code>\uff08\u4e0d\u5e26 <code>?q=...<\/code>\uff09\u5c06\u76f4\u63a5\u8fd4\u56de 422 \u9519\u8bef\uff0c\u63d0\u793a\u8be5\u5b57\u6bb5\u7f3a\u5931 (<code>field required<\/code>)\u3002<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">6. \u591a\u4e2a\u540c\u540d\u67e5\u8be2\u53c2\u6570 (List)<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u5982\u679c URL \u4e2d\u5305\u542b\u591a\u4e2a\u540c\u540d\u7684\u67e5\u8be2\u53c2\u6570\uff08\u4f8b\u5982 <code>?q=apple&amp;q=banana<\/code>\uff09\uff0c\u4f60\u53ef\u4ee5\u5c06\u7c7b\u578b\u58f0\u660e\u4e3a <code>list<\/code>\uff0cFastAPI \u4f1a\u81ea\u52a8\u5c06\u5176\u89e3\u6790\u4e3a\u5217\u8868\u3002<\/p>\n\n\n\n<div class=\"chp-code-block chp-theme-github-dark chp-wrap-on\" data-chp-language=\"plaintext\" data-chp-line-start=\"1\" data-chp-highlight=\"\"><div class=\"chp-toolbar\"><div class=\"chp-toolbar-left\"><span class=\"chp-dots\"><span><\/span><span><\/span><span><\/span><\/span><span class=\"chp-language-label\">\u7eaf\u6587\u672c<\/span><\/div><div class=\"chp-toolbar-right\"><button type=\"button\" class=\"chp-copy-btn\" aria-label=\"\u590d\u5236\u4ee3\u7801\"><svg class=\"chp-icon-copy\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\"><path fill=\"currentColor\" d=\"M16 1H4c-1.1 0-2 .9-2 2v14h2V3h12V1zm3 4H8c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h11c1.1 0 2-.9 2-2V7c0-1.1-.9-2-2-2zm0 16H8V7h11v14z\"\/><\/svg><svg class=\"chp-icon-check\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\" style=\"display:none;\"><path fill=\"currentColor\" d=\"M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z\"\/><\/svg><span class=\"chp-copy-text\">\u590d\u5236<\/span><\/button><\/div><\/div><div class=\"chp-code-wrapper\"><div class=\"chp-line-numbers\" aria-hidden=\"true\"><span>1<\/span><span>2<\/span><span>3<\/span><span>4<\/span><span>5<\/span><span>6<\/span><span>7<\/span><span>8<\/span><span>9<\/span><span>10<\/span><span>11<\/span><\/div><pre class=\"chp-pre\" style=\"font-size:14px;\"><code class=\"language-plaintext\">from typing import Annotated\nfrom fastapi import FastAPI, Query\n\napp = FastAPI()\n\n@app.get(&quot;\/items\/&quot;)\nasync def read_items(\n    # \u5141\u8bb8\u4f20\u9012\u591a\u4e2a q \u53c2\u6570\uff0c\u4f8b\u5982 ?q=apple&amp;q=banana\n    q: Annotated[list[str] | None, Query(title=&quot;Query string&quot;)] = None\n):\n    return {&quot;q&quot;: q}<\/code><\/pre><\/div><\/div>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u8bbf\u95ee <code>\/items\/?q=apple&amp;q=banana<\/code>\uff1a\u8fd4\u56de <code>{\"q\": [\"apple\", \"banana\"]}<\/code>\u3002<\/li>\n\n\n\n<li>\u8bbf\u95ee <code>\/items\/<\/code>\uff1a\u8fd4\u56de <code>{\"q\": None}<\/code>\u3002<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">7. \u5e03\u5c14\u503c\u8f6c\u6362 (Boolean Conversion)<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">FastAPI \u5bf9\u5e03\u5c14\u67e5\u8be2\u53c2\u6570\u6709\u7279\u6b8a\u7684\u667a\u80fd\u89e3\u6790\u3002\u5b83\u4e0d\u4ec5\u8bc6\u522b <code>true<\/code>\/<code>false<\/code>\uff0c\u8fd8\u80fd\u8bc6\u522b <code>1<\/code>\/<code>0<\/code>\u3001<code>on<\/code>\/<code>off<\/code>\u3001<code>yes<\/code>\/<code>no<\/code> \u7b49\u3002<\/p>\n\n\n\n<div class=\"chp-code-block chp-theme-github-dark chp-wrap-on\" data-chp-language=\"plaintext\" data-chp-line-start=\"1\" data-chp-highlight=\"\"><div class=\"chp-toolbar\"><div class=\"chp-toolbar-left\"><span class=\"chp-dots\"><span><\/span><span><\/span><span><\/span><\/span><span class=\"chp-language-label\">\u7eaf\u6587\u672c<\/span><\/div><div class=\"chp-toolbar-right\"><button type=\"button\" class=\"chp-copy-btn\" aria-label=\"\u590d\u5236\u4ee3\u7801\"><svg class=\"chp-icon-copy\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\"><path fill=\"currentColor\" d=\"M16 1H4c-1.1 0-2 .9-2 2v14h2V3h12V1zm3 4H8c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h11c1.1 0 2-.9 2-2V7c0-1.1-.9-2-2-2zm0 16H8V7h11v14z\"\/><\/svg><svg class=\"chp-icon-check\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\" style=\"display:none;\"><path fill=\"currentColor\" d=\"M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z\"\/><\/svg><span class=\"chp-copy-text\">\u590d\u5236<\/span><\/button><\/div><\/div><div class=\"chp-code-wrapper\"><div class=\"chp-line-numbers\" aria-hidden=\"true\"><span>1<\/span><span>2<\/span><span>3<\/span><span>4<\/span><span>5<\/span><\/div><pre class=\"chp-pre\" style=\"font-size:14px;\"><code class=\"language-plaintext\">@app.get(&quot;\/items\/&quot;)\nasync def read_items(short: bool = False):\n    if short:\n        return {&quot;message&quot;: &quot;Short response&quot;}\n    return {&quot;message&quot;: &quot;Full response with lots of details&quot;}<\/code><\/pre><\/div><\/div>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u8bbf\u95ee <code>\/items\/?short=1<\/code>\u3001<code>\/items\/?short=true<\/code>\u3001<code>\/items\/?short=yes<\/code>\uff1a<code>short<\/code> \u90fd\u4f1a\u88ab\u89e3\u6790\u4e3a <code>True<\/code>\u3002<\/li>\n\n\n\n<li>\u8bbf\u95ee <code>\/items\/?short=0<\/code> \u6216\u4e0d\u4f20\uff1a<code>short<\/code> \u4e3a <code>False<\/code>\u3002<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">8. \u6807\u8bb0\u53c2\u6570\u4e3a\u201c\u5df2\u5e9f\u5f03\u201d (Deprecated)<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u5982\u679c\u4f60\u7684 API \u6b63\u5728\u8fed\u4ee3\uff0c\u67d0\u4e2a\u67e5\u8be2\u53c2\u6570\u5373\u5c06\u88ab\u79fb\u9664\uff0c\u53ef\u4ee5\u4f7f\u7528 <code>deprecated=True<\/code>\u3002\u8fd9\u4f1a\u5728\u81ea\u52a8\u751f\u6210\u7684 Swagger UI (OpenAPI) \u6587\u6863\u4e2d\u5c06\u8be5\u53c2\u6570\u5212\u6389\u5e76\u6807\u8bb0\u4e3a\u5e9f\u5f03\uff0c\u4f46\u4ee3\u7801\u4ecd\u4f1a\u6b63\u5e38\u5904\u7406\u5b83\u3002<\/p>\n\n\n\n<div class=\"chp-code-block chp-theme-github-dark chp-wrap-on\" data-chp-language=\"plaintext\" data-chp-line-start=\"1\" data-chp-highlight=\"\"><div class=\"chp-toolbar\"><div class=\"chp-toolbar-left\"><span class=\"chp-dots\"><span><\/span><span><\/span><span><\/span><\/span><span class=\"chp-language-label\">\u7eaf\u6587\u672c<\/span><\/div><div class=\"chp-toolbar-right\"><button type=\"button\" class=\"chp-copy-btn\" aria-label=\"\u590d\u5236\u4ee3\u7801\"><svg class=\"chp-icon-copy\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\"><path fill=\"currentColor\" d=\"M16 1H4c-1.1 0-2 .9-2 2v14h2V3h12V1zm3 4H8c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h11c1.1 0 2-.9 2-2V7c0-1.1-.9-2-2-2zm0 16H8V7h11v14z\"\/><\/svg><svg class=\"chp-icon-check\" viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\" style=\"display:none;\"><path fill=\"currentColor\" d=\"M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z\"\/><\/svg><span class=\"chp-copy-text\">\u590d\u5236<\/span><\/button><\/div><\/div><div class=\"chp-code-wrapper\"><div class=\"chp-line-numbers\" aria-hidden=\"true\"><span>1<\/span><span>2<\/span><span>3<\/span><span>4<\/span><span>5<\/span><\/div><pre class=\"chp-pre\" style=\"font-size:14px;\"><code class=\"language-plaintext\">@app.get(&quot;\/items\/&quot;)\nasync def read_items(\n    q: Annotated[str | None, Query(deprecated=True)] = None\n):\n    return {&quot;q&quot;: q}<\/code><\/pre><\/div><\/div>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">\ud83d\udca1 \u6700\u4f73\u5b9e\u8df5\u603b\u7ed3<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>\u4f18\u5148\u4f7f\u7528 <code>Annotated<\/code><\/strong>\uff1a\u8fd9\u662f\u73b0\u4ee3 FastAPI \u5f00\u53d1\u7684\u6807\u51c6\uff0c\u4ee3\u7801\u53ef\u8bfb\u6027\u548c\u7c7b\u578b\u63d0\u793a\u652f\u6301\u6700\u597d\u3002<\/li>\n\n\n\n<li><strong>\u63d0\u4f9b\u5408\u7406\u7684\u9ed8\u8ba4\u503c<\/strong>\uff1a\u9664\u975e\u4e1a\u52a1\u903b\u8f91\u5f3a\u5236\u8981\u6c42\uff0c\u5426\u5219\u5c3d\u91cf\u4e3a\u67e5\u8be2\u53c2\u6570\u63d0\u4f9b\u9ed8\u8ba4\u503c\uff08\u5982\u5206\u9875\u7684 <code>skip=0<\/code>, <code>limit=10<\/code>\uff09\uff0c\u4ee5\u63d0\u9ad8 API \u7684\u6613\u7528\u6027\u3002<\/li>\n\n\n\n<li><strong>\u5584\u7528 <code>Query<\/code> \u7684 <code>description<\/code><\/strong>\uff1a\u586b\u5199\u6e05\u6670\u7684\u63cf\u8ff0\uff0cFastAPI \u4f1a\u81ea\u52a8\u5c06\u5176\u6e32\u67d3\u5230 Swagger UI \u4e2d\uff0c\u6781\u5927\u964d\u4f4e\u524d\u7aef\/\u5176\u4ed6\u5f00\u53d1\u8005\u7684\u5bf9\u63a5\u6210\u672c\u3002<\/li>\n\n\n\n<li><strong>\u6ce8\u610f\u7c7b\u578b\u5b89\u5168<\/strong>\uff1a\u59cb\u7ec8\u58f0\u660e\u7c7b\u578b\uff08\u5982 <code>int<\/code>, <code>str<\/code>, <code>bool<\/code>\uff09\uff0c\u8ba9 FastAPI \u5e2e\u4f60\u6321\u6389\u975e\u6cd5\u7684\u8f93\u5165\uff0c\u800c\u4e0d\u662f\u5728\u4e1a\u52a1\u903b\u8f91\u91cc\u624b\u52a8\u505a <code>try...except<\/code>\u3002<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">\u5982\u679c\u4f60\u9700\u8981\u4e86\u89e3\u5982\u4f55\u5904\u7406\u66f4\u590d\u6742\u7684\u573a\u666f\uff08\u5982\u4f9d\u8d56\u6ce8\u5165\u4e2d\u7684\u67e5\u8be2\u53c2\u6570\u3001\u81ea\u5b9a\u4e49\u89e3\u6790\u903b\u8f91\u7b49\uff09\uff0c\u968f\u65f6\u544a\u8bc9\u6211\uff01<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u5728 FastAPI \u4e2d\uff0c\u67e5\u8be2\u53c2\u6570\uff08Query Paramet&hellip;<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[14],"tags":[],"class_list":["post-132","post","type-post","status-publish","format-standard","hentry","category-fastapi-"],"_links":{"self":[{"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/posts\/132","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/comments?post=132"}],"version-history":[{"count":1,"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/posts\/132\/revisions"}],"predecessor-version":[{"id":133,"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/posts\/132\/revisions\/133"}],"wp:attachment":[{"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/media?parent=132"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/categories?post=132"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/tags?post=132"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}