为什么在Notebook里用Python代码调用API老是断开连接-人工智能-PHP中文网

jupyter notebook中api调用频繁报connectionerror等，主因是内核空闲超时被重置、代理未继承、ssl上下文异常或中间设备拦截；需禁用kernel_idle_timeout、手动注入代理、优化requests/aiohttp连接池、验证ssl证书及socket连通性。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

为什么在notebook里用python代码调用api老是断开连接

在Jupyter Notebook里用Python代码调用API时反复出现ConnectionError、ServerDisconnectedError或ConnectionResetError，不是代码写错了，而是Notebook的运行环境与网络连接机制存在隐性冲突——内核长期空闲被强制回收、代理配置未继承、SSL上下文复用异常，这些都会让看似正常的requests.post()突然失败。

确认是否是Notebook内核自动重启导致的连接中断

打开终端，执行 jupyter notebook list 查看当前运行的Notebook服务进程PID；再观察你运行API请求前后的内核状态：【若Kernel status从“idle”变为“starting”再变回“idle”，说明内核已被重置】。这种重置会清空所有已建立的TCP连接池，导致后续请求直接抛出ConnectionResetError。

在Notebook单元格顶部添加魔法命令：%%capture 并在下方执行 import time; time.sleep(65)，等待超时后立刻运行API调用——如果此时报错，基本可锁定为内核空闲超时机制触发。

永久禁用该行为：编辑 ~/.jupyter/jupyter_notebook_config.py，加入 c.NotebookApp.kernel_idle_timeout = 0（设为0即关闭自动回收）；若文件不存在，先运行 jupyter notebook --generate-config 创建。

检查Notebook是否继承了系统/conda环境的代理设置

Jupyter Notebook启动时默认不读取shell中的HTTP_PROXY/HTTPS_PROXY环境变量，而你的Python脚本却依赖它们访问外部API。

方法一：在Notebook首个单元格中手动注入代理配置

import os
os.environ["HTTP_PROXY"] = "http://127.0.0.1:8080"
os.environ["HTTPS_PROXY"] = "http://127.0.0.1:8080"

方法二：从命令行启动Notebook时显式传入（推荐）

HTTP_PROXY=http://127.0.0.1:8080 HTTPS_PROXY=http://127.0.0.1:8080 jupyter notebook

⚠️ 注意：若使用conda环境，确保代理地址在该环境中可达——例如代理运行在宿主机，而Notebook内核运行在WSL2中，则需将127.0.0.1换成宿主机真实IP（如192.168.1.100），否则连接永远失败。

修复aiohttp或requests长连接在Notebook中被静默断开

第一步：禁用requests的默认连接池复用

不要直接用 requests.get(url)，改用带显式Session和连接控制的写法：

Shadows Python Sensei

Python 最佳实践助手——代码规范、设计模式、性能优化、测试与类型注解。适用于编写或审查 Python 代码。

下载

import requests
session = requests.Session()
adapter = requests.adapters.HTTPAdapter(pool_connections=10, pool_maxsize=10, max_retries=3)
session.mount("http://", adapter)
session.mount("https://", adapter)

第二步：为aiohttp配置抗断连TCPConnector

import aiohttp
connector = aiohttp.TCPConnector(
  limit=100,
  limit_per_host=30,
  keepalive_timeout=300,
  enable_cleanup_closed=True
)
session = aiohttp.ClientSession(connector=connector)

第三步：强制绕过SSL证书验证（仅调试用）

某些企业防火墙会中间劫持HTTPS连接并替换证书，导致Notebook内核校验失败。临时加参数：verify=False，但必须配合import urllib3; urllib3.disable_warnings()，否则仍会报Warning并可能中断。

排查Notebook所在机器与目标API之间的中间设备干扰

① 在Notebook中执行原始socket探测，绕过高层库干扰：

import socket
s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
s.settimeout(5)
s.connect(("api.openai.com", 443))
print("TCP连接成功")
s.close()

② 若上步失败，说明问题出在网络链路层——可能是公司Nginx网关、云厂商ELB或本地杀毒软件拦截了443端口。

③ 若上步成功但requests仍报错，问题一定在TLS握手或HTTP协议栈：尝试用curl命令在同台机器终端运行 curl -v https://api.openai.com，对比Notebook中输出的TLS版本、SNI字段和证书链是否一致。

④ 关键动作：在Notebook中打印底层SSL配置

import ssl
print(ssl.OPENSSL_VERSION)
print(ssl.create_default_context().get_ca_certs())

若返回空列表或路径指向一个不存在的cert.pem，说明Python环境缺失可信根证书——需运行 pip install certifi 并设置 import os; os.environ["SSL_CERT_FILE"] = "path/to/site-packages/certifi/cacert.pem"。