线上问题：FastAPI和trafilatura出现ValueError: signal only works in main thread of the main interpreter

最新推荐文章于 2026-05-07 10:00:42 发布

原创最新推荐文章于 2026-05-07 10:00:42 发布 · 1.9k 阅读

收录于

当前文章被以下社区和专栏收录：

架构设计专栏收录该内容

62 篇文章 ¥9.90 ¥99.00

订阅专栏

超级会员免费看

博客详细描述了一个使用FastAPI和trafilatura时遇到的问题，即在非主线程中调用signal方法导致ValueError。分析了Python 3.8以上版本的限制以及trafilatura第三方库的源码，指出trafilatura的超时设置（EXTRACTION_TIMEOUT）可能导致这个问题。解决方案是将trafilatura的超时时间配置为0，以防止在非主线程中调用signal。此外，还提供了trafilatura官方的解决方案链接和Flask的取消reload模式建议。

1 场景复现

相关工具及版本：
fastapi==0.95.0
trafilatura==1.5.0
python==3.10
使用FastAPI开发获取URL内容的接口：
抛出的异常如下：

File “/app/src/utils/file_process_util.py”, line 66, in request_data_from_url
text = trafilatura.extract(source_data)
File “/usr/local/lib/python3.10/site-packages/trafilatura/core.py”, line 1050, in extract
signal(SIGALRM, timeout_handler)
File “/usr/local/lib/python3.10/signal.py”, line 56, in signal
handler = _signal.signal(_enum_to_int(signalnum), _enum_to_int(handler))
ValueError: signal only works in main thread of the main interpreter