三周精通FastAPI:33 在编辑器中调试

时间:2024-11-07 07:30:47

官方文档:https://fastapi.tiangolo.com/zh/tutorial/debugging/

调试

你可以在编辑器中连接调试器,例如使用 Visual Studio Code 或 PyCharm。

调用 uvicorn

在你的 FastAPI 应用中直接导入 uvicorn 并运行:

import uvicorn
from fastapi import FastAPI

app = FastAPI()


@app.get("/")
def root():
    a = "a"
    b = "b" + a
    return {"hello world": b}


if __name__ == "__main__":
    uvicorn.run(app, host="0.0.0.0", port=8000)

关于 __name__ == "__main__"

__name__ == "__main__" 的主要目的是使用以下代码调用文件时执行一些代码:

python myapp.py

而当其它文件导入它时并不会被调用,像这样:

from myapp import app
更多细节

假设你的文件命名为 myapp.py。如果你这样运行:

python myapp.py

那么文件中由 Python 自动创建的内部变量 __name__,会将字符串 "__main__" 作为值。

所以,下面这部分代码才会运行:

uvicorn.run(app, host="0.0.0.0", port=8000) 

如果你是导入这个模块(文件)就不会这样。

因此,如果你的另一个文件 importer.py 像这样:

from myapp import app 
# Some more code 

在这种情况下,myapp.py 内部的自动变量不会有值为 "__main__" 的变量 __name__。所以,下面这一行不会被执行:

if __name__ == "__main__":
    uvicorn.run(app, host="0.0.0.0", port=8000)

Info

更多信息请检查 Python 官方文档.

使用你的调试器运行代码

由于是从代码直接运行的 Uvicorn 服务器,所以你可以从调试器直接调用 Python 程序(你的 FastAPI 应用)。


例如,你可以在 Visual Studio Code 中:

  • 进入到「调试」面板。
  • 「添加配置...」。
  • 选中「Python」
  • 运行「Python:当前文件(集成终端)」选项的调试器。

然后它会使用你的 FastAPI 代码开启服务器,停在断点处,等等。

看起来可能是这样:


如果使用 Pycharm,你可以:

  • 打开「运行」菜单。
  • 选中「调试...」。
  • 然后出现一个上下文菜单。
  • 选择要调试的文件(本例中的 main.py)。

然后它会使用你的 FastAPI 代码开启服务器,停在断点处,等等。

看起来可能是这样:

实践

在FreeBSD下调试(失败)

从头开始实践操作,首先启动VSCode,比如FreeBSD安装:

pkg install vscode

启动vscode,创建文件myqpp.py:

import uvicorn
from fastapi import FastAPI

app = FastAPI()


@app.get("/")
def root():
    a = "a"
    b = "b" + a
    return {"hello world": b}


if __name__ == "__main__":
    uvicorn.run(app, host="0.0.0.0", port=8000)

设置调试器

安装CodeLLDB,说不支持FreeBSD

安装调试器:Python Debugger (PyDev)

pip install pydev

点击左边的“运行和调试”

调试失败,报错:

Error. Unable to launch pydevd: expected: python to exist (bad python.pydev.pythonExecutable (from settings)).

可能是FreeBSD下的问题。

在MAC下调试

在b = "b" + a 打断点,执行调试

在“调试控制台”显示:

INFO:     Started server process [66934]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)

这时候用web浏览器,浏览http://127.0.0.1:8000

发现焦点跳回到VSCode 断点处,且断点红点用黄箭头包围,证明执行到断点:

这时候按f10继续执行,

发现浏览器这时候输出了期待的信息

{"hello world":"ba"}

证明程序继续执行了。

调试实践完毕!