FastAPI无法加载静态文件问题求助

数据老陈

2026-7-1

FastAPI静态文件404问题解决

问题原因

初始代码仅配置了根路由返回index.html，但FastAPI默认不会自动处理根路径下的静态文件请求（如/style.css、/script.js），导致这些资源返回404。
你后来添加的StaticFiles配置挂载了/static路径，但静态文件（style.css、script.js）并不在static目录中，且HTML里的资源引用路径是根相对路径（./style.css），和挂载的/static路径不匹配，因此仍然无法找到资源。

解决方案

方案一：调整项目结构（推荐）

重新整理项目目录，将静态文件放到static子目录：

apitest
    - main.py
    - static/
        - index.html
        - style.css
        - script.js

修改main.py，挂载static目录到根路径，并启用HTML自动索引：

from fastapi import FastAPI
from fastapi.staticfiles import StaticFiles

app = FastAPI()

# 挂载静态文件目录，html=True会自动返回目录下的index.html
app.mount("/", StaticFiles(directory="static", html=True), name="static")

保持HTML里的资源引用路径不变（./style.css、./script.js），现在请求会被正确映射到static目录下的对应文件。

方案二：不修改项目结构，直接挂载当前目录

如果不想调整目录结构，可将当前项目目录作为静态文件目录挂载，同时保留根路由返回index.html：

from fastapi import FastAPI
from fastapi.responses import FileResponse
from fastapi.staticfiles import StaticFiles

app = FastAPI()

# 先定义根路由，再挂载静态文件（路由匹配按顺序执行）
@app.get("/")
def read_root():
    return FileResponse('index.html')

# 挂载当前目录为静态文件目录，处理除根路径外的静态资源请求
app.mount("/", StaticFiles(directory="."), name="static")