{"id":124,"date":"2026-06-14T10:02:24","date_gmt":"2026-06-14T02:02:24","guid":{"rendered":"https:\/\/www.52runoob.com\/?p=124"},"modified":"2026-06-14T10:02:24","modified_gmt":"2026-06-14T02:02:24","slug":"fastapi-%e8%a1%a8%e5%8d%95%e6%95%b0%e6%8d%ae","status":"publish","type":"post","link":"https:\/\/www.52runoob.com\/index.php\/2026\/06\/14\/fastapi-%e8%a1%a8%e5%8d%95%e6%95%b0%e6%8d%ae\/","title":{"rendered":"FastAPI \u8868\u5355\u6570\u636e"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">\u5728 FastAPI \u4e2d\uff0c\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u5b83\u671f\u671b\u5ba2\u6237\u7aef\u53d1\u9001\u7684\u662f <strong>JSON<\/strong> \u683c\u5f0f\u7684\u8bf7\u6c42\u4f53\u3002\u5982\u679c\u4f60\u9700\u8981\u63a5\u6536 HTML \u8868\u5355\u63d0\u4ea4\u7684\u6570\u636e\uff08<code>application\/x-www-form-urlencoded<\/code> \u6216 <code>multipart\/form-data<\/code>\uff09\uff0c\u6216\u8005\u9700\u8981\u5904\u7406<strong>\u6587\u4ef6\u4e0a\u4f20<\/strong>\uff0c\u4f60\u9700\u8981\u4f7f\u7528 FastAPI \u63d0\u4f9b\u7684 <code>Form<\/code>\u3001<code>File<\/code> \u548c <code>UploadFile<\/code> \u4f9d\u8d56\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u4e0b\u9762\u6211\u5c06\u4ece<strong>\u73af\u5883\u51c6\u5907<\/strong>\u3001<strong>\u57fa\u7840\u8868\u5355<\/strong>\u3001<strong>\u6587\u4ef6\u4e0a\u4f20<\/strong>\u5230<strong>\u8fdb\u9636\u6280\u5de7<\/strong>\uff0c\u4e3a\u4f60\u7cfb\u7edf\u68b3\u7406 FastAPI \u5904\u7406\u8868\u5355\u6570\u636e\u7684\u5b8c\u6574\u6307\u5357\u3002<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">\u26a0\ufe0f \u7b2c\u4e00\u6b65\uff1a\u5b89\u88c5\u5fc5\u5907\u4f9d\u8d56\uff08\u65b0\u624b\u6700\u5e38\u8e29\u7684\u5751\uff09<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">FastAPI \u672c\u8eab\u4e0d\u5305\u542b\u89e3\u6790\u8868\u5355\u6570\u636e\u7684\u5e93\u3002\u5728\u5904\u7406\u4efb\u4f55\u8868\u5355\u6216\u6587\u4ef6\u4e0a\u4f20\u4e4b\u524d\uff0c<strong>\u5fc5\u987b<\/strong>\u5b89\u88c5 <code>python-multipart<\/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><\/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<p class=\"wp-block-paragraph\"><em>\u5982\u679c\u4e0d\u5b89\u88c5\uff0c\u5f53\u4f60\u5c1d\u8bd5\u8bbf\u95ee\u5e26\u6709 <code>Form<\/code> \u6216 <code>File<\/code> \u53c2\u6570\u7684\u8def\u7531\u65f6\uff0cFastAPI \u4f1a\u629b\u51fa <code>ImportError<\/code>\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\">\u4e8c\u3001 \u5904\u7406\u666e\u901a\u8868\u5355\u5b57\u6bb5 (<code>Form<\/code>)<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u4f7f\u7528 <code>Form<\/code> \u53ef\u4ee5\u63a5\u6536 HTML \u8868\u5355\u4e2d\u7684\u6587\u672c\u5b57\u6bb5\u3002\u5b83\u7684\u7528\u6cd5\u4e0e <code>Query<\/code> \u6216 <code>Path<\/code> \u975e\u5e38\u76f8\u4f3c\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 fastapi import FastAPI, Form\n\napp = FastAPI()\n\n@app.post(&quot;\/login\/&quot;)\ndef login(\n    username: str = Form(..., description=&quot;\u7528\u6237\u540d&quot;), \n    password: str = Form(..., description=&quot;\u5bc6\u7801&quot;),\n    remember_me: bool = Form(default=False)\n):\n    # Form(...) \u4e2d\u7684 ... \u8868\u793a\u8be5\u5b57\u6bb5\u662f\u5fc5\u586b\u9879 (Required)\n    return {\n        &quot;username&quot;: username,\n        &quot;password_length&quot;: len(password),\n        &quot;remember_me&quot;: remember_me\n    }<\/code><\/pre><\/div><\/div>\n\n\n\n<p class=\"wp-block-paragraph\"><em>\ud83d\udca1 \u63d0\u793a\uff1a\u5728 Swagger UI (<code>\/docs<\/code>) \u4e2d\uff0cFastAPI \u4f1a\u81ea\u52a8\u5c06\u6b64\u63a5\u53e3\u6e32\u67d3\u4e3a\u4e00\u4e2a\u771f\u5b9e\u7684 HTML \u8868\u5355\uff0c\u4f60\u53ef\u4ee5\u76f4\u63a5\u5728\u6d4f\u89c8\u5668\u4e2d\u586b\u5199\u5e76\u6d4b\u8bd5\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\">\u4e09\u3001 \u5904\u7406\u6587\u4ef6\u4e0a\u4f20 (<code>File<\/code> \u4e0e <code>UploadFile<\/code>)<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u5904\u7406\u6587\u4ef6\u65f6\uff0cFastAPI \u63d0\u4f9b\u4e86\u4e24\u4e2a\u9009\u9879\uff1a<code>File<\/code> \u548c <code>UploadFile<\/code>\u3002<strong>\u5f3a\u70c8\u63a8\u8350\u4f7f\u7528 <code>UploadFile<\/code><\/strong>\u3002<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th class=\"has-text-align-left\" data-align=\"left\">\u7279\u6027<\/th><th class=\"has-text-align-left\" data-align=\"left\"><code>File<\/code> (bytes)<\/th><th class=\"has-text-align-left\" data-align=\"left\"><code>UploadFile<\/code> (\u63a8\u8350 \ud83c\udf1f)<\/th><\/tr><\/thead><tbody><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>\u8fd4\u56de\u503c<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">\u6574\u4e2a\u6587\u4ef6\u7684\u5b57\u8282\u6d41 (<code>bytes<\/code>)<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u7c7b\u4f3c Python \u6587\u4ef6\u5bf9\u8c61\u7684\u63a5\u53e3<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>\u5185\u5b58\u5360\u7528<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">\u6574\u4e2a\u6587\u4ef6\u52a0\u8f7d\u5230\u5185\u5b58\uff0c\u5927\u6587\u4ef6\u4f1a\u5bfc\u81f4 OOM<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u5b58\u50a8\u5728\u4e34\u65f6\u6587\u4ef6\u4e2d\uff0c\u5185\u5b58\u5360\u7528\u6781\u5c0f<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>\u5f02\u6b65\u652f\u6301<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">\u5426 (\u540c\u6b65\u8bfb\u53d6)<\/td><td class=\"has-text-align-left\" data-align=\"left\"><strong>\u662f<\/strong> (<code>await file.read()<\/code>)<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>\u5143\u6570\u636e<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">\u65e0<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u5305\u542b <code>filename<\/code>, <code>content_type<\/code>, <code>size<\/code> \u7b49<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">1. \u5355\u6587\u4ef6\u4e0a\u4f20\u793a\u4f8b<\/h4>\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><\/div><pre class=\"chp-pre\" style=\"font-size:14px;\"><code class=\"language-plaintext\">from fastapi import FastAPI, File, UploadFile\nimport shutil\n\napp = FastAPI()\n\n@app.post(&quot;\/upload\/&quot;)\nasync def upload_file(file: UploadFile = File(..., description=&quot;\u8bf7\u9009\u62e9\u8981\u4e0a\u4f20\u7684\u6587\u4ef6&quot;)):\n    # 1. \u83b7\u53d6\u6587\u4ef6\u5143\u6570\u636e\n    filename = file.filename\n    content_type = file.content_type\n\n    # 2. \u8bfb\u53d6\u6587\u4ef6\u5185\u5bb9 (\u5f02\u6b65\u64cd\u4f5c\uff0c\u4e0d\u4f1a\u963b\u585e\u4e8b\u4ef6\u5faa\u73af)\n    contents = await file.read()\n\n    # 3. \u4fdd\u5b58\u6587\u4ef6\u5230\u672c\u5730 (\u793a\u4f8b)\n    # with open(f&quot;uploads\/{filename}&quot;, &quot;wb&quot;) as buffer:\n    #     shutil.copyfileobj(file.file, buffer)\n\n    return {\n        &quot;filename&quot;: filename,\n        &quot;content_type&quot;: content_type,\n        &quot;size_bytes&quot;: len(contents)\n    }<\/code><\/pre><\/div><\/div>\n\n\n\n<h4 class=\"wp-block-heading\">2. \u591a\u6587\u4ef6\u4e0a\u4f20\u793a\u4f8b<\/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> \u5373\u53ef\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><\/div><pre class=\"chp-pre\" style=\"font-size:14px;\"><code class=\"language-plaintext\">from typing import List\n\n@app.post(&quot;\/upload-multiple\/&quot;)\nasync def upload_multiple_files(files: list[UploadFile] = File(...)):\n    filenames = [file.filename for file in files]\n    return {&quot;uploaded_files&quot;: filenames, &quot;count&quot;: len(files)}<\/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\">\u56db\u3001 \u6df7\u5408\u573a\u666f\uff1a\u8868\u5355\u5b57\u6bb5 + \u6587\u4ef6\u4e0a\u4f20<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u5728\u5b9e\u9645\u4e1a\u52a1\u4e2d\uff08\u5982\u7528\u6237\u4fee\u6539\u8d44\u6599\u3001\u53d1\u5e03\u6587\u7ae0\uff09\uff0c\u901a\u5e38\u9700\u8981\u540c\u65f6\u63d0\u4ea4\u6587\u672c\u5b57\u6bb5\u548c\u6587\u4ef6\u3002FastAPI \u5b8c\u7f8e\u652f\u6301\u8fd9\u79cd\u6df7\u5408\u6a21\u5f0f\uff0c\u5b83\u4f1a\u81ea\u52a8\u5c06\u8bf7\u6c42\u8bc6\u522b\u4e3a <code>multipart\/form-data<\/code>\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><\/div><pre class=\"chp-pre\" style=\"font-size:14px;\"><code class=\"language-plaintext\">from fastapi import FastAPI, Form, File, UploadFile\n\napp = FastAPI()\n\n@app.post(&quot;\/create-post\/&quot;)\nasync def create_post(\n    title: str = Form(..., max_length=100),\n    content: str = Form(...),\n    category: str = Form(default=&quot;general&quot;),\n    cover_image: UploadFile = File(default=None) # \u6587\u4ef6\u662f\u53ef\u9009\u7684\n):\n    post_data = {\n        &quot;title&quot;: title,\n        &quot;content&quot;: content,\n        &quot;category&quot;: category,\n    }\n\n    if cover_image:\n        post_data[&quot;cover_image_name&quot;] = cover_image.filename\n        # \u53ef\u4ee5\u5728\u8fd9\u91cc\u5904\u7406\u56fe\u7247\u4fdd\u5b58\u903b\u8f91\n\n    return {&quot;status&quot;: &quot;success&quot;, &quot;data&quot;: post_data}<\/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\">\u4e94\u3001 \u8fdb\u9636\u6280\u5de7\uff1a\u5982\u4f55\u8ba9\u8868\u5355\u6570\u636e\u652f\u6301 Pydantic \u6a21\u578b\uff1f<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u75db\u70b9<\/strong>\uff1aFastAPI \u539f\u751f<strong>\u4e0d\u652f\u6301<\/strong>\u76f4\u63a5\u4f7f\u7528 Pydantic <code>BaseModel<\/code> \u6765\u63a5\u6536\u8868\u5355\u6570\u636e\uff08<code>BaseModel<\/code> \u9ed8\u8ba4\u53ea\u89e3\u6790 JSON\uff09\u3002\u5982\u679c\u4f60\u6709\u4e00\u4e2a\u5305\u542b 10 \u4e2a\u5b57\u6bb5\u7684\u8868\u5355\uff0c\u5199 10 \u4e2a <code>Form(...)<\/code> \u4f1a\u975e\u5e38\u7e41\u7410\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u89e3\u51b3\u65b9\u6848<\/strong>\uff1a\u4f7f\u7528\u81ea\u5b9a\u4e49\u4f9d\u8d56\uff0c\u624b\u52a8\u5c06\u8868\u5355\u6570\u636e\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><\/div><pre class=\"chp-pre\" style=\"font-size:14px;\"><code class=\"language-plaintext\">from fastapi import FastAPI, Form, Depends\nfrom pydantic import BaseModel, Field\n\n# 1. \u5b9a\u4e49\u4f60\u7684 Pydantic \u6a21\u578b (\u548c\u63a5\u6536 JSON \u65f6\u4e00\u6837)\nclass UserRegistration(BaseModel):\n    username: str = Field(..., min_length=3)\n    email: str\n    age: int | None = None\n\n# 2. \u521b\u5efa\u4e00\u4e2a\u4f9d\u8d56\u51fd\u6570\uff0c\u8d1f\u8d23\u4ece Form \u4e2d\u63d0\u53d6\u6570\u636e\u5e76\u6784\u5efa\u6a21\u578b\ndef parse_user_form(\n    username: str = Form(...),\n    email: str = Form(...),\n    age: int | None = Form(default=None)\n) -&gt; UserRegistration:\n    # \u5c06\u8868\u5355\u6570\u636e\u7ec4\u88c5\u6210 Pydantic \u6a21\u578b\uff0c\u4eab\u53d7\u81ea\u52a8\u9a8c\u8bc1\n    return UserRegistration(username=username, email=email, age=age)\n\n# 3. \u5728\u8def\u7531\u4e2d\u4f7f\u7528\n@app.post(&quot;\/register-form\/&quot;)\ndef register_user(user: UserRegistration = Depends(parse_user_form)):\n    # \u6b64\u65f6 user \u5df2\u7ecf\u662f\u4e00\u4e2a\u9a8c\u8bc1\u901a\u8fc7\u7684 UserRegistration \u5bf9\u8c61\n    return {&quot;message&quot;: f&quot;\u7528\u6237 {user.username} \u6ce8\u518c\u6210\u529f&quot;, &quot;email&quot;: user.email}<\/code><\/pre><\/div><\/div>\n\n\n\n<p class=\"wp-block-paragraph\"><em>(\u6ce8\uff1a\u5bf9\u4e8e\u66f4\u590d\u6742\u7684\u9879\u76ee\uff0c\u4e5f\u53ef\u4ee5\u4f7f\u7528\u7b2c\u4e09\u65b9\u5e93\u5982 <code>fastapi-form<\/code> \u6216 <code>pydantic-form<\/code> \u6765\u7b80\u5316\u8fd9\u4e2a\u8fc7\u7a0b)<\/em><\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">\u516d\u3001 \u6700\u4f73\u5b9e\u8df5\u4e0e\u907f\u5751\u6307\u5357<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>\u59cb\u7ec8\u4f7f\u7528 <code>async def<\/code> \u5904\u7406\u6587\u4ef6<\/strong>\uff1a<code>UploadFile<\/code> \u7684 <code>.read()<\/code>, <code>.write()<\/code>, <code>.seek()<\/code> \u7b49\u65b9\u6cd5\u90fd\u662f\u5f02\u6b65\u7684\u3002\u4f7f\u7528 <code>async def<\/code> \u53ef\u4ee5\u8ba9 FastAPI \u5728\u5904\u7406\u5927\u6587\u4ef6\u4e0a\u4f20\u65f6\uff0c\u4f9d\u7136\u80fd\u591f\u54cd\u5e94\u5176\u4ed6\u5ba2\u6237\u7aef\u7684\u8bf7\u6c42\uff0c\u4fdd\u6301\u9ad8\u5e76\u53d1\u6027\u80fd\u3002<\/li>\n\n\n\n<li><strong>\u9650\u5236\u6587\u4ef6\u5927\u5c0f<\/strong>\uff1a\u4e3a\u4e86\u9632\u6b62\u6076\u610f\u4e0a\u4f20\u8d85\u5927\u6587\u4ef6\u8017\u5c3d\u670d\u52a1\u5668\u5185\u5b58\u6216\u78c1\u76d8\uff0c\u5efa\u8bae\u5728 Nginx \u5c42\u9762\u6216\u4ee3\u7801\u5c42\u9762\u9650\u5236\u5927\u5c0f\u3002<\/li>\n<\/ol>\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><\/div><pre class=\"chp-pre\" style=\"font-size:14px;\"><code class=\"language-plaintext\">   MAX_FILE_SIZE = 5 * 1024 * 1024  # 5MB\n\n   @app.post(&quot;\/upload\/&quot;)\n   async def upload(file: UploadFile = File(...)):\n       contents = await file.read()\n       if len(contents) &gt; MAX_FILE_SIZE:\n           raise HTTPException(status_code=413, detail=&quot;\u6587\u4ef6\u8fc7\u5927&quot;)\n       # ...<\/code><\/pre><\/div><\/div>\n\n\n\n<ol start=\"3\" class=\"wp-block-list\">\n<li><strong>\u9a8c\u8bc1\u6587\u4ef6\u7c7b\u578b<\/strong>\uff1a\u4e0d\u8981\u53ea\u4fe1\u4efb <code>file.content_type<\/code>\uff08\u5ba2\u6237\u7aef\u53ef\u4ee5\u4f2a\u9020\uff09\uff0c\u6700\u597d\u68c0\u67e5\u6587\u4ef6\u6269\u5c55\u540d\u6216\u4f7f\u7528 <code>python-magic<\/code> \u5e93\u68c0\u67e5\u6587\u4ef6\u7684\u771f\u5b9e MIME \u7c7b\u578b\u3002<\/li>\n\n\n\n<li><strong>\u6e05\u7406\u4e34\u65f6\u6587\u4ef6<\/strong>\uff1a<code>UploadFile<\/code> \u4f1a\u5728\u8bf7\u6c42\u7ed3\u675f\u540e\u81ea\u52a8\u5173\u95ed\uff0c\u4f46\u5982\u679c\u4f60\u7684\u903b\u8f91\u4e2d\u521b\u5efa\u4e86\u4e34\u65f6\u6587\u4ef6\uff0c\u8bf7\u786e\u4fdd\u5728 <code>finally<\/code> \u5757\u6216\u4f9d\u8d56\u9879\u7684 <code>yield<\/code> \u4e2d\u6e05\u7406\u5b83\u4eec\u3002<\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">\u603b\u7ed3\uff1a\u8868\u5355\u5904\u7406\u901f\u67e5\u8868<\/h3>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th class=\"has-text-align-left\" data-align=\"left\">\u9700\u6c42<\/th><th class=\"has-text-align-left\" data-align=\"left\">\u63a8\u8350\u7528\u6cd5<\/th><th class=\"has-text-align-left\" data-align=\"left\">\u793a\u4f8b<\/th><\/tr><\/thead><tbody><tr><td class=\"has-text-align-left\" data-align=\"left\">\u63a5\u6536\u666e\u901a\u6587\u672c\u8868\u5355<\/td><td class=\"has-text-align-left\" data-align=\"left\"><code>str = Form(...)<\/code><\/td><td class=\"has-text-align-left\" data-align=\"left\"><code>username: str = Form(...)<\/code><\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">\u63a5\u6536\u5355\u4e2a\u6587\u4ef6<\/td><td class=\"has-text-align-left\" data-align=\"left\"><code>UploadFile = File(...)<\/code><\/td><td class=\"has-text-align-left\" data-align=\"left\"><code>file: UploadFile = File(...)<\/code><\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">\u63a5\u6536\u591a\u4e2a\u6587\u4ef6<\/td><td class=\"has-text-align-left\" data-align=\"left\"><code>list[UploadFile] = File(...)<\/code><\/td><td class=\"has-text-align-left\" data-align=\"left\"><code>files: list[UploadFile] = File(...)<\/code><\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">\u53ef\u9009\u7684\u8868\u5355\u5b57\u6bb5<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u8d4b\u4e88\u9ed8\u8ba4\u503c<\/td><td class=\"has-text-align-left\" data-align=\"left\"><code>bio: str = Form(default=\"\")<\/code><\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">\u4f18\u96c5\u5904\u7406\u590d\u6742\u8868\u5355<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u81ea\u5b9a\u4e49 <code>Depends<\/code> \u6620\u5c04\u5230 Pydantic<\/td><td class=\"has-text-align-left\" data-align=\"left\"><code>user: User = Depends(parse_form)<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">\u4f60\u73b0\u5728\u662f\u5426\u6709\u4e00\u4e2a\u5177\u4f53\u7684\u8868\u5355\u4e0a\u4f20\u9700\u6c42\uff08\u4f8b\u5982\uff1a<strong>\u5982\u4f55\u63a5\u6536\u524d\u7aef\u4f20\u6765\u7684 Base64 \u56fe\u7247<\/strong>\uff0c\u6216\u8005<strong>\u5982\u4f55\u7ed3\u5408 SQLAlchemy \u4fdd\u5b58\u5e26\u6709\u56fe\u7247\u7684\u8bb0\u5f55<\/strong>\uff09\uff1f\u544a\u8bc9\u6211\uff0c\u6211\u53ef\u4ee5\u4e3a\u4f60\u63d0\u4f9b\u9488\u5bf9\u6027\u7684\u4ee3\u7801\u6a21\u677f\uff01<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u5728 FastAPI \u4e2d\uff0c\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u5b83\u671f\u671b\u5ba2\u6237\u7aef\u53d1\u9001\u7684\u662f JS&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-124","post","type-post","status-publish","format-standard","hentry","category-fastapi-"],"_links":{"self":[{"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/posts\/124","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=124"}],"version-history":[{"count":1,"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/posts\/124\/revisions"}],"predecessor-version":[{"id":125,"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/posts\/124\/revisions\/125"}],"wp:attachment":[{"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/media?parent=124"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/categories?post=124"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.52runoob.com\/index.php\/wp-json\/wp\/v2\/tags?post=124"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}