Docs: 添加对 fastapi_reload 在 Windows 平台额外影响的说明

[CherryGS]

在 python 3.8 之后 , win平台默认使用 ProactorEventLoop , 而 uvicorn 在启动 reload 后会强制绑定默认事件循环为 SelectorEventLoop , 后者在 win 平台的可使用性不如前者 , 也会导致一些使用 asyncio 的包出错(如 playwright)
以下是一些相关信息
uvicorn#529
python doc

[codecov]

Codecov Report

Merging #830 (2632854) into master (a8a6eb8) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##           master     #830   +/-   ##
=======================================
  Coverage   76.41%   76.41%           
=======================================
  Files          42       42           
  Lines        3083     3083           
=======================================
  Hits         2356     2356           
  Misses        727      727           

Flag	Coverage Δ
unittests	76.41% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update a8a6eb8...2632854. Read the comment docs.

[github-actions]

🚀 Deployed on https://deploy-preview-830--nonebot2.netlify.app

[mnixry]

根据 @SK-415 反馈, 似乎beta2锁定的uvicorn版本^0.17.0 又强制换回了SelectorEventLoop, 然后彻底禁用了Windows平台的重载, 你可以检查一下是不是这样

[CherryGS]

环境

代码

不开启 reload

开启 reload

开启 reload 后启动会有 warning

[SK-415]

你说的情况在低版本 uvicorn<=1.14.0 中确实存在，Windows 系统下 ProactorEventLoop 会被替换为 SelectorEventLoop，进而导致需要调用 asyncio.subprocess.create_subprocess_* 的库，如 Playwright 无法正常工作。我也曾写过一个 补丁 强行替换回默认事件循环以解决这个问题。

但是在 encode/uvicorn#1070 中，为了适配 Python 3.1.0，Windows 下原本用于替换 ProactorEventLoop 的事件循环从 SelectorEventLoop 变为了 WindowsSelectorEventLoopPolicy。经过实测，Playwright 和 --reload 模式均可在 WindowsSelectorEventLoopPolicy 下正常工作，无需做任何修改。

然后在 encode/uvicorn#1257 中，Windows 系统带了 --reload 参数的情况下才会被替换默认事件循环，在此之前并不会区分，而是统一根据平台修改。上文截图中的 warning 也是在这次更新中添加的。

上述改动在 uvicorn>=1.16.0 之后均有效，因此只要保证 Uvicorn 为较新版本就不存在 encode/uvicorn#529 的问题。

[CherryGS]

在这个版本下 , 添加 reload 行为启动后 playwright 仍然会报错 , 这也是 pypi 能获取到的最高版本了

在 env 里定义 fastapi_reload=true , 就会启动 reload , 同时有一条 warning , 见上

[SK-415]

确认，问题确实依然存在，感谢指正。

我没有注意到 Nonebot2 增加了 fastapi_reload 配置且默认为 False，导致我误以为启动了 reload 模式，实则根据 encode/uvicorn#1257 使用的依然是默认事件循环。

改正后重新测试，确认使用的是 SelectorEventLoop，Playwright 等库依然无法使用。

[SK-415]

但是我觉得这条提示的信息量有点少，对于没有经验的开发者很难意识到 “事件循环强制绑定到 SelectorEventLoop” 会有什么影响。

我的建议是找个地方（比如就这里）总结一下可能产生的问题，并在提示最后加一句类似于：“可能导致部分库无法正常运行（详见……）” 并附上总结的链接。

[mnixry]

感谢PR, 可以稍微改一下上述这些地方的表述

另外请将修改后的文档同步到website/docs/tutorial, 以便使未来版本的文档也包含该更改

[mnixry]

感谢PR，将会在稍后合并。