如何使用 FastAPI 返回自定義 404 未找到頁面？
簡介
創(chuàng)建 Web 應(yīng)用程序時(shí)，這是必不可少的適當(dāng)?shù)靥幚?HTTP 狀態(tài)代碼。您可能遇到的一種常見狀態(tài)代碼是 404 Not Found，這表示無法找到所請求的資源。本文將探討使用 FastAPI（一種用于構(gòu)建 Web API 的現(xiàn)代 Python 框架）返回自定義 404 頁面的各種方法。
異常處理方法
FastAPI 提供了一種便捷的方法通過其異常處理機(jī)制來處理異常。您可以定義自定義處理程序來處理 404 異常并返回自定義響應(yīng)。
<code class="python">@app.exception_handler(404)
async def not_found_exception_handler(request: Request, exc: HTTPException):
return RedirectResponse('https://fastapi.tiangolo.com')</code>
或者，您可以使用 FastAPI 類的 exception_handlers 參數(shù)來注冊全局異常處理程序。
<code class="python">async def not_found_error(request: Request, exc: HTTPException):
return RedirectResponse('https://fastapi.tiangolo.com')
exception_handlers = {404: not_found_error}
app = FastAPI(exception_handlers=exception_handlers)</code>
中間件方法
另一種方法是創(chuàng)建一個(gè)中間件來攔截 HTTP 響應(yīng)并檢查狀態(tài)代碼。如果狀態(tài)碼為 404，則中間件可以在響應(yīng)到達(dá)客戶端之前返回自定義響應(yīng)。
<code class="python">@app.middleware("http")
async def redirect_on_not_found(request: Request, call_next):
response = await call_next(request)
if response.status_code == 404:
return RedirectResponse("https://fastapi.tiangolo.com")
else:
return response</code>
自定義頁面響應(yīng)
使用上述方法，您可以返回一個(gè)簡單的重定向響應(yīng)。但是，您還可以通過定義模板并返回 TemplateResponse 來創(chuàng)建更加自定義的 404 頁面。
<code class="python">from fastapi.templating import Jinja2Templates
templates = Jinja2Templates(directory='templates')
async def not_found_error(request: Request, exc: HTTPException):
return templates.TemplateResponse('404.html', {'request': request}, status_code=404)</code>
在 templates 目錄中，創(chuàng)建一個(gè) 404.html 模板，其中包含自定義 404 頁面所需的內(nèi)容。
結(jié)論
通過利用異常處理程序、中間件或自定義頁面響應(yīng)，您可以輕松在 FastAPI 中實(shí)現(xiàn)自定義 404 Not Found 頁面。這使您能夠在找不到所請求的資源時(shí)提供更加用戶友好的體驗(yàn)，從而增強(qiáng) Web 應(yīng)用程序的整體用戶體驗(yàn)。
以上是如何在 FastAPI 中創(chuàng)建自定義 404 頁面？的詳細(xì)內(nèi)容。更多信息請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！
熱AI工具
Undress AI Tool
免費(fèi)脫衣服圖片
Undresser.AI Undress
人工智能驅(qū)動的應(yīng)用程序，用于創(chuàng)建逼真的裸體照片
AI Clothes Remover
用于從照片中去除衣服的在線人工智能工具。
Clothoff.io
AI脫衣機(jī)
Video Face Swap
使用我們完全免費(fèi)的人工智能換臉工具輕松在任何視頻中換臉！
熱門文章
熱工具
記事本++7.3.1
好用且免費(fèi)的代碼編輯器
SublimeText3漢化版
中文版，非常好用
禪工作室 13.0.1
功能強(qiáng)大的PHP集成開發(fā)環(huán)境
Dreamweaver CS6
視覺化網(wǎng)頁開發(fā)工具
SublimeText3 Mac版
神級代碼編輯軟件(SublimeText3)
如何處理Python中的API身份驗(yàn)證
Jul 13, 2025 am 02:22 AM
處理API認(rèn)證的關(guān)鍵在于理解并正確使用認(rèn)證方式。1.APIKey是最簡單的認(rèn)證方式，通常放在請求頭或URL參數(shù)中；2.BasicAuth使用用戶名和密碼進(jìn)行Base64編碼傳輸，適合內(nèi)部系統(tǒng)；3.OAuth2需先通過client_id和client_secret獲取Token，再在請求頭中帶上BearerToken；4.為應(yīng)對Token過期，可封裝Token管理類自動刷新Token；總之，根據(jù)文檔選擇合適方式，并安全存儲密鑰信息是關(guān)鍵。
解釋Python斷言。
Jul 07, 2025 am 12:14 AM
Assert是Python用于調(diào)試的斷言工具，當(dāng)條件不滿足時(shí)拋出AssertionError。其語法為assert條件加可選錯(cuò)誤信息，適用于內(nèi)部邏輯驗(yàn)證如參數(shù)檢查、狀態(tài)確認(rèn)等，但不能用于安全或用戶輸入檢查，且應(yīng)配合清晰提示信息使用，僅限開發(fā)階段輔助調(diào)試而非替代異常處理。
什么是Python迭代器？
Jul 08, 2025 am 02:56 AM
Inpython，IteratorSareObjectSthallowloopingThroughCollectionsByImplementing_iter __（）和__next __（）。1）iteratorsWiaTheIteratorProtocol，使用__ITER __（）toreTurnterateratoratoranteratoratoranteratoratorAnterAnteratoratorant antheittheext__（）
什么是Python型提示？
Jul 07, 2025 am 02:55 AM
typeHintsInpyThonsolverbromblemboyofambiguityandPotentialBugSindyNamalytyCodeByallowingDevelopsosteSpecefectifyExpectedTypes.theyenhancereadability，enablellybugdetection，andimprovetool.typehintsupport.typehintsareadsareadsareadsareadsareadsareadsareadsareadsareaddedusidocolon（
如何一次迭代兩個(gè)列表
Jul 09, 2025 am 01:13 AM
在Python中同時(shí)遍歷兩個(gè)列表的常用方法是使用zip()函數(shù)，它會按順序配對多個(gè)列表并以最短為準(zhǔn)；若列表長度不一致，可使用itertools.zip_longest()以最長為準(zhǔn)并填充缺失值；結(jié)合enumerate()可同時(shí)獲取索引。1.zip()簡潔實(shí)用，適合成對數(shù)據(jù)迭代；2.zip_longest()處理不一致長度時(shí)可填充默認(rèn)值；3.enumerate(zip())可在遍歷時(shí)獲取索引，滿足多種復(fù)雜場景需求。
Python Fastapi教程
Jul 12, 2025 am 02:42 AM
要使用Python創(chuàng)建現(xiàn)代高效的API，推薦使用FastAPI；其基于標(biāo)準(zhǔn)Python類型提示，可自動生成文檔，性能優(yōu)越。安裝FastAPI和ASGI服務(wù)器uvicorn后，即可編寫接口代碼。通過定義路由、編寫處理函數(shù)并返回?cái)?shù)據(jù)，可以快速構(gòu)建API。FastAPI支持多種HTTP方法，并提供自動生成的SwaggerUI和ReDoc文檔系統(tǒng)。URL參數(shù)可通過路徑定義捕獲，查詢參數(shù)則通過函數(shù)參數(shù)設(shè)置默認(rèn)值實(shí)現(xiàn)。合理使用Pydantic模型有助于提升開發(fā)效率和準(zhǔn)確性。
如何用Python測試API
Jul 12, 2025 am 02:47 AM
要測試API需使用Python的Requests庫，步驟為安裝庫、發(fā)送請求、驗(yàn)證響應(yīng)、設(shè)置超時(shí)與重試。首先通過pipinstallrequests安裝庫；接著用requests.get()或requests.post()等方法發(fā)送GET或POST請求；然后檢查response.status_code和response.json()確保返回結(jié)果符合預(yù)期；最后可添加timeout參數(shù)設(shè)置超時(shí)時(shí)間，并結(jié)合retrying庫實(shí)現(xiàn)自動重試以增強(qiáng)穩(wěn)定性。
設(shè)置并使用Python虛擬環(huán)境
Jul 06, 2025 am 02:56 AM
虛擬環(huán)境能隔離不同項(xiàng)目的依賴。使用Python自帶的venv模塊創(chuàng)建，命令為python-mvenvenv；激活方式：Windows用env\Scripts\activate，macOS/Linux用sourceenv/bin/activate；安裝包使用pipinstall，生成需求文件用pipfreeze>requirements.txt，恢復(fù)環(huán)境用pipinstall-rrequirements.txt；注意事項(xiàng)包括不提交到Git、每次新開終端需重新激活、可用IDE自動識別切換。
