{"id":137,"date":"2026-06-16T14:38:03","date_gmt":"2026-06-16T06:38:03","guid":{"rendered":"https:\/\/www.52runoob.com\/?p=137"},"modified":"2026-06-16T14:38:03","modified_gmt":"2026-06-16T06:38:03","slug":"fastapi-%e8%a1%a8%e5%8d%95%e6%95%b0%e6%8d%ae-2","status":"publish","type":"post","link":"https:\/\/www.52runoob.com\/index.php\/2026\/06\/16\/fastapi-%e8%a1%a8%e5%8d%95%e6%95%b0%e6%8d%ae-2\/","title":{"rendered":"FastAPI \u8868\u5355\u6570\u636e"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">\u5728 FastAPI \u4e2d\u5904\u7406\u8868\u5355\u6570\u636e\uff08Form Data\uff0c\u901a\u5e38\u7528\u4e8e HTML <code>&lt;form&gt;<\/code> \u63d0\u4ea4\uff0c\u5185\u5bb9\u7c7b\u578b\u4e3a <code>application\/x-www-form-urlencoded<\/code> \u6216 <code>multipart\/form-data<\/code>\uff09\u975e\u5e38\u76f4\u89c2\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u4f46\u5728\u6b64\u4e4b\u524d\uff0c\u6709\u4e00\u4e2a<strong>\u6781\u5176\u91cd\u8981<\/strong>\u7684\u524d\u7f6e\u6761\u4ef6\uff1a<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\u26a0\ufe0f 0. \u5fc5\u987b\u5b89\u88c5 <code>python-multipart<\/code><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">FastAPI \u5904\u7406\u8868\u5355\u6570\u636e\u4f9d\u8d56\u4e8e\u7b2c\u4e09\u65b9\u5e93 <code>python-multipart<\/code>\u3002\u5982\u679c\u4f60\u6ca1\u6709\u5b89\u88c5\u5b83\uff0c\u5c1d\u8bd5\u63a5\u6536\u8868\u5355\u6570\u636e\u65f6\u4f1a\u62a5\u9519\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><\/div><pre class=\"chp-pre\" style=\"font-size:14px;\"><code class=\"language-plaintext\">pip install python-multipart<\/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\">1. \u57fa\u7840\u7528\u6cd5\uff1a\u63a5\u6536\u8868\u5355\u5b57\u6bb5<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u4f7f\u7528 <code>fastapi.Form<\/code> \u6765\u58f0\u660e\u8868\u5355\u5b57\u6bb5\u3002\u5f3a\u70c8\u5efa\u8bae\u4f7f\u7528 <code>Annotated<\/code>\uff08FastAPI 0.95.0+ \u63a8\u8350\u5199\u6cd5\uff09\uff0c\u4ee5\u4fdd\u6301\u7c7b\u578b\u63d0\u793a\u7684\u6e05\u6670\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, Form\n\napp = FastAPI()\n\n@app.post(&quot;\/login\/&quot;)\nasync def login(\n    username: Annotated[str, Form()],\n    password: Annotated[str, Form(min_length=6, max_length=50)] # \u652f\u6301\u9a8c\u8bc1\u89c4\u5219\n):\n    return {&quot;message&quot;: f&quot;Login successful for {username}&quot;}<\/code><\/pre><\/div><\/div>\n\n\n\n<p class=\"wp-block-paragraph\"><em>\u6ce8\u610f\uff1a\u8868\u5355\u5b57\u6bb5\u53ef\u4ee5\u5305\u542b\u63cf\u8ff0\u3001\u9ed8\u8ba4\u503c\u548c\u9a8c\u8bc1\u89c4\u5219\uff08\u4e0e Query\/Path \u53c2\u6570\u7c7b\u4f3c\uff09\u3002<\/em><\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">2. \u5904\u7406\u6587\u4ef6\u4e0a\u4f20<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u5f53\u8868\u5355\u5305\u542b\u6587\u4ef6\u65f6\uff08<code>multipart\/form-data<\/code>\uff09\uff0c\u9700\u8981\u4f7f\u7528 <code>File<\/code> \u548c <code>UploadFile<\/code>\u3002<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>File<\/code>\uff1a\u7ee7\u627f\u81ea <code>Form<\/code>\uff0c\u7528\u4e8e\u58f0\u660e\u8fd9\u662f\u4e00\u4e2a\u6587\u4ef6\u7c7b\u578b\u7684\u8868\u5355\u5b57\u6bb5\u3002<\/li>\n\n\n\n<li><code>UploadFile<\/code>\uff1aFastAPI \u63d0\u4f9b\u7684\u6587\u4ef6\u5bf9\u8c61\uff0c\u652f\u6301\u5f02\u6b65\u8bfb\u53d6\uff0c\u4e14\u4e0d\u4f1a\u5c06\u6574\u4e2a\u6587\u4ef6\u52a0\u8f7d\u5230\u5185\u5b58\u4e2d\uff08\u9002\u5408\u5927\u6587\u4ef6\uff09\u3002<\/li>\n<\/ul>\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 typing import Annotated\nfrom fastapi import FastAPI, File, UploadFile\n\napp = FastAPI()\n\n@app.post(&quot;\/upload\/&quot;)\nasync def upload_file(\n    file: Annotated[UploadFile, File(description=&quot;A file to be uploaded&quot;)]\n):\n    # \u8bfb\u53d6\u6587\u4ef6\u5185\u5bb9 (\u5f02\u6b65)\n    content = await file.read()\n\n    return {\n        &quot;filename&quot;: file.filename,\n        &quot;content_type&quot;: file.content_type,\n        &quot;size_bytes&quot;: len(content)\n    }<\/code><\/pre><\/div><\/div>\n\n\n\n<h4 class=\"wp-block-heading\">\u4e0a\u4f20\u591a\u4e2a\u6587\u4ef6<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">\u53ea\u9700\u5c06\u7c7b\u578b\u63d0\u793a\u6539\u4e3a\u5217\u8868 <code>list[UploadFile]<\/code>\uff1a<\/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><\/div><pre class=\"chp-pre\" style=\"font-size:14px;\"><code class=\"language-plaintext\">from typing import Annotated, List\nfrom fastapi import FastAPI, File, UploadFile\n\napp = FastAPI()\n\n@app.post(&quot;\/upload-multiple\/&quot;)\nasync def upload_multiple_files(\n    files: Annotated[List[UploadFile], File()]\n):\n    return {\n        &quot;filenames&quot;: [file.filename for file in files],\n        &quot;count&quot;: len(files)\n each file in files]\n    }<\/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\">3. \u8868\u5355\u5b57\u6bb5 + \u6587\u4ef6\u6df7\u5408\u63d0\u4ea4<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u4f60\u53ef\u4ee5\u540c\u65f6\u5728\u4e00\u4e2a\u8def\u5f84\u64cd\u4f5c\u51fd\u6570\u4e2d\u58f0\u660e <code>Form<\/code> \u548c <code>File<\/code>\uff0cFastAPI \u4f1a\u81ea\u52a8\u5904\u7406 <code>multipart\/form-data<\/code> \u8bf7\u6c42\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><\/div><pre class=\"chp-pre\" style=\"font-size:14px;\"><code class=\"language-plaintext\">from typing import Annotated\nfrom fastapi import FastAPI, Form, File, UploadFile\n\napp = FastAPI()\n\n@app.post(&quot;\/profile\/&quot;)\nasync def create_profile(\n    name: Annotated[str, Form()],\n    age: Annotated[int, Form()],\n    avatar: Annotated[UploadFile, File()]\n):\n    return {\n        &quot;name&quot;: name,\n        &quot;age&quot;: age,\n        &quot;avatar_filename&quot;: avatar.filename\n    }<\/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\">4. \u8fdb\u9636\uff1a\u5982\u4f55\u4f18\u96c5\u5730\u7ed3\u5408 Pydantic \u6a21\u578b\uff1f\uff08\u5e38\u89c1\u75db\u70b9\uff09<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">FastAPI <strong>\u539f\u751f\u4e0d\u652f\u6301<\/strong>\u76f4\u63a5\u5c06 Pydantic \u6a21\u578b\u7528\u4e8e <code>Form<\/code> \u6570\u636e\uff08<code>Body<\/code> \u9ed8\u8ba4\u89e3\u6790\u4e3a JSON\uff09\u3002\u5982\u679c\u4f60\u6709\u4e00\u4e2a\u590d\u6742\u7684\u8868\u5355\uff0c\u624b\u52a8\u5199\u4e00\u5806 <code>Form()<\/code> \u4f1a\u5f88\u7e41\u7410\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u6700\u4f73\u89e3\u51b3\u65b9\u6848\uff1a\u7ed3\u5408\u201c\u4f9d\u8d56\u6ce8\u5165\u201d<\/strong>\uff08\u6b63\u5982\u6211\u4eec\u4e0a\u4e00\u4e2a\u8bdd\u9898\u8ba8\u8bba\u7684\uff09\u3002\u6211\u4eec\u53ef\u4ee5\u5199\u4e00\u4e2a\u4f9d\u8d56\u51fd\u6570\uff0c\u5c06\u8868\u5355\u5b57\u6bb5\u6620\u5c04\u5230 Pydantic \u6a21\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><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><span>18<\/span><span>19<\/span><span>20<\/span><span>21<\/span><span>22<\/span><span>23<\/span><span>24<\/span><span>25<\/span><span>26<\/span><span>27<\/span><span>28<\/span><span>29<\/span><span>30<\/span><span>31<\/span><span>32<\/span><\/div><pre class=\"chp-pre\" style=\"font-size:14px;\"><code class=\"language-plaintext\">from typing import Annotated\nfrom pydantic import BaseModel, Field\nfrom fastapi import FastAPI, Form, Depends, HTTPException\n\napp = FastAPI()\n\n# 1. \u5b9a\u4e49\u4f60\u7684 Pydantic \u6a21\u578b\nclass UserCreateForm(BaseModel):\n    username: str = Field(min_length=3)\n    email: str\n    age: int = Field(ge=18, description=&quot;Must be 18 or older&quot;)\n\n# 2. \u521b\u5efa\u4e00\u4e2a\u4f9d\u8d56\u51fd\u6570\uff0c\u8d1f\u8d23\u63a5\u6536 Form \u5e76\u7ec4\u88c5\u6210 Pydantic \u6a21\u578b\ndef user_form_dependency(\n    username: Annotated[str, Form()],\n    email: Annotated[str, Form()],\n    age: Annotated[int, Form()]\n) -&gt; UserCreateForm:\n    # \u8fd9\u91cc\u53ef\u4ee5\u8fdb\u884c\u989d\u5916\u7684\u81ea\u5b9a\u4e49\u903b\u8f91\uff0c\u6216\u8005\u76f4\u63a5\u8fd4\u56de\u6a21\u578b\u5b9e\u4f8b\n    # Pydantic \u4f1a\u81ea\u52a8\u8fdb\u884c\u6570\u636e\u9a8c\u8bc1\n    return UserCreateForm(username=username, email=email, age=age)\n\n# 3. \u5728\u8def\u5f84\u64cd\u4f5c\u4e2d\u4f7f\u7528 Depends \u6ce8\u5165\n@app.post(&quot;\/users\/&quot;)\nasync def create_user(\n    user: Annotated[UserCreateForm, Depends(user_form_dependency)]\n):\n    # \u6b64\u65f6 user \u5df2\u7ecf\u662f\u4e00\u4e2a\u9a8c\u8bc1\u901a\u8fc7\u7684 UserCreateForm \u5b9e\u4f8b\n    return {\n        &quot;message&quot;: &quot;User created&quot;,\n        &quot;data&quot;: user.model_dump() # Pydantic V2 \u7684\u5b57\u5178\u8f6c\u6362\u65b9\u6cd5\n    }<\/code><\/pre><\/div><\/div>\n\n\n\n<p class=\"wp-block-paragraph\"><em>\u8fd9\u79cd\u65b9\u6cd5\u65e2\u4fdd\u7559\u4e86 Pydantic \u5f3a\u5927\u7684\u9a8c\u8bc1\u548c\u6587\u6863\u751f\u6210\u80fd\u529b\uff0c\u53c8\u5b8c\u7f8e\u652f\u6301\u4e86 HTML \u8868\u5355\u63d0\u4ea4\u3002<\/em><\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">5. \u53ef\u9009\u7684\u8868\u5355\u5b57\u6bb5<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u5982\u679c\u67d0\u4e2a\u8868\u5355\u5b57\u6bb5\u4e0d\u662f\u5fc5\u586b\u7684\uff0c\u53ea\u9700\u63d0\u4f9b\u9ed8\u8ba4\u503c\uff08\u901a\u5e38\u662f <code>None<\/code>\uff09\uff0c\u5e76\u6307\u5b9a\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><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, Form\n\napp = FastAPI()\n\n@app.post(&quot;\/items\/&quot;)\nasync def create_item(\n    name: Annotated[str, Form()],\n    description: Annotated[str | None, Form()] = None # \u53ef\u9009\u5b57\u6bb5\n):\n    return {&quot;name&quot;: name, &quot;description&quot;: description}<\/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\">\u26a0\ufe0f \u91cd\u8981\u6ce8\u610f\u4e8b\u9879<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>\u4e0d\u80fd\u6df7\u7528 JSON Body \u548c Form<\/strong>\uff1a<br>\u5728\u4e00\u4e2a\u8bf7\u6c42\u4e2d\uff0c\u4f60\u4e0d\u80fd\u540c\u65f6\u671f\u671b\u63a5\u6536 JSON Body (<code>Body()<\/code>) \u548c\u8868\u5355\u6570\u636e (<code>Form()<\/code>)\u3002HTTP \u534f\u8bae\u7684 <code>Content-Type<\/code> \u53ea\u80fd\u662f\u5176\u4e2d\u4e4b\u4e00\u3002\u5982\u679c\u4f60\u9700\u8981\u540c\u65f6\u63a5\u6536\u590d\u6742\u5bf9\u8c61\u548c\u6587\u4ef6\uff0c\u5fc5\u987b\u5168\u90e8\u4f7f\u7528 <code>Form<\/code> \/ <code>File<\/code>\uff08\u5373 <code>multipart\/form-data<\/code>\uff09\u3002<\/li>\n\n\n\n<li><strong>Swagger UI \u6d4b\u8bd5<\/strong>\uff1a<br>FastAPI \u7684\u81ea\u52a8\u6587\u6863\uff08<code>\/docs<\/code>\uff09\u5b8c\u5168\u652f\u6301\u8868\u5355\u548c\u6587\u4ef6\u4e0a\u4f20\u6d4b\u8bd5\u3002\u5bf9\u4e8e <code>UploadFile<\/code>\uff0cSwagger UI \u4f1a\u81ea\u52a8\u6e32\u67d3\u51fa\u4e00\u4e2a\u6587\u4ef6\u9009\u62e9\u6309\u94ae\u3002<\/li>\n\n\n\n<li><strong>\u5927\u6587\u4ef6\u5904\u7406<\/strong>\uff1a<br>\u59cb\u7ec8\u4f7f\u7528 <code>UploadFile<\/code> \u800c\u4e0d\u662f\u76f4\u63a5\u8bfb\u53d6 <code>bytes<\/code>\uff0c\u56e0\u4e3a <code>UploadFile<\/code> \u4f7f\u7528 Python \u7684 <code>SpooledTemporaryFile<\/code>\uff0c\u5728\u6587\u4ef6\u8d85\u8fc7\u4e00\u5b9a\u5927\u5c0f\uff08\u9ed8\u8ba4 1MB\uff09\u65f6\u4f1a\u81ea\u52a8\u5199\u5165\u78c1\u76d8\uff0c\u9632\u6b62\u5185\u5b58\u6ea2\u51fa (OOM)\u3002<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">\u5982\u679c\u4f60\u6709\u7279\u5b9a\u7684\u8868\u5355\u573a\u666f\uff08\u4f8b\u5982\uff1a\u52a8\u6001\u8868\u5355\u5b57\u6bb5\u3001\u4e0e\u6570\u636e\u5e93 ORM \u7ed3\u5408\u4fdd\u5b58\u8868\u5355\u6570\u636e\uff09\uff0c\u53ef\u4ee5\u544a\u8bc9\u6211\uff0c\u6211\u53ef\u4ee5\u63d0\u4f9b\u66f4\u5177\u4f53\u7684\u4ee3\u7801\uff01<\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u5728 FastAPI \u4e2d\u5904\u7406\u8868\u5355\u6570\u636e\uff08Form Data\uff0c\u901a\u5e38&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-137","post","type-post","status-publish","format-standard","hentry","category-fastapi-"],"_links":{"self":[{"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/posts\/137","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=137"}],"version-history":[{"count":1,"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/posts\/137\/revisions"}],"predecessor-version":[{"id":138,"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/posts\/137\/revisions\/138"}],"wp:attachment":[{"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/media?parent=137"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/categories?post=137"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/tags?post=137"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}