您现在的位置是：首页 >学无止境 >端口冲突导致的Failed to load API definition网站首页学无止境

发现问题

在反复开启和终止main.py文件的运行后，出现了一个问题  本地运行的8080端口访问fastapi文档时，http://127.0.0.1:8080/docs 出现  Failed to load API definition   如下图所示：

解决问题

端口冲突导致的Failed to load API definition

 后来发现改变端口可以恢复web文档的访问，但是当又反复开启和终止服务时 ，端口又不能访问了。这时猜想是不是因为反复开启和终止main.py 导致某一个端口的进程被系统创建很多，导致端口冲突。

于是我开始查找端口 ，因为我用的是8080端口 ，如下

查找占用8080端口的进程

--打开命令提示符：
Win+R 回车
--使用netstat命令查找端口占用情况
netstat -ano | findstr 8080
--记录进程ID
在显示的列表中，找到与127.0.0.1:8080相关的行，并记下最后一列的进程ID

终止占用8080端口的进程

--使用taskkill命令终止进程：
输入taskkill /F /PID [进程ID]命令，其中[进程ID]是你之前记下的数字。这将强制终止该进程。
--确认进程已终止：
你可以再次运行netstat -ano | findstr 8080命令来确认8080端口是否已被释放

可能导致问题的多种原因 

说明一下关于端口冲突，除了端口冲突还有其他情况也会导致问题发生 如下：

1. 端口冲突

端口是网络通信中的一个关键资源，用于区分不同的网络服务。当多个进程尝试绑定到同一个端口时，就会发生端口冲突。操作系统通常不允许这种情况发生，以保护网络通信的稳定性和安全性。因此，当新的进程尝试绑定到已被占用的端口时，它可能会失败，并导致服务无法启动。

2. 资源限制

每个进程都需要占用一定的系统资源，包括CPU、内存、文件句柄和网络连接等。当系统资源达到极限时，新的进程可能无法成功创建或运行。虽然端口占用本身不一定会直接导致资源耗尽，但它可能是系统资源紧张的一个信号。在资源紧张的情况下，新的进程可能会因为无法获取必要的资源而失败。

3. 服务状态不一致

当多个进程尝试使用同一个端口时，可能会导致服务状态的不一致。例如，一个进程可能正在使用该端口提供服务，而另一个进程则试图启动并绑定到同一个端口。这种不一致的状态可能会导致服务中断或异常行为，包括无法加载API定义文件。

4. 网络问题或配置错误

除了端口冲突和资源限制外，网络问题或配置错误也可能导致“Failed to load API definition”错误。例如，如果API服务器配置不正确或网络不稳定，客户端可能无法成功连接到服务器并加载API定义。

5. Python脚本的运行方式

Python脚本通常是通过Python解释器来运行的。当你运行一个Python文件时，Python解释器会读取该文件中的代码，并将其转换为可执行的机器码。这个过程是在一个新的进程中完成的。因此，每次你运行Python文件时，都会创建一个新的进程来执行代码。

 其中的Python脚本的运行方式也是导致这次问题的原因