python进程在容器中收不到sigint/sighup，根本原因是debugpy（v1.6+）默认拦截并吞掉这些信号，不转发给被调试进程，与容器无关；其信号劫持行为不可禁用，需通过子进程运行、pid 1 配置或attach模式绕过。
为什么 Python 进程在容器里收不到 SIGINT/SIGHUP
VSCode 调试器（debugpy）默认会拦截并吞掉 SIGINT（Ctrl+C）和 SIGHUP，导致你无法在调试中正常中断或重载程序。这不是容器的问题，而是 debugpy 的行为设计：它把信号转成调试事件，不转发给被调试的 Python 进程。
-
debugpy从 v1.6 开始默认启用信号拦截，且无开关关闭 —— 官方明确不提供禁用选项 - 即使你在代码里写了
signal.signal(signal.SIGINT, handler)，也会被debugpy层屏蔽 - 容器内用
docker stop或kill -2发送信号时，Python 进程收不到，表现为“卡死”或忽略退出逻辑 - 这个行为在本地直接运行
python -m debugpy时一样存在，跟 Docker 无关，但容器环境会让问题更隐蔽（比如你误以为是 PID 1 问题）
如何让 Python 在 debugpy 下响应 Ctrl+C
唯一可靠的方式是绕过 debugpy 的信号劫持路径，改用进程级信号透传。核心思路：让 Python 主进程不被 debugpy 直接包裹，而是在子进程中运行业务代码。
- 启动命令改成：
python -c "import os; os.execv('/usr/local/bin/python', ['python', '-u', 'main.py'])"，再用debugpyattach 到该进程（而非 launch） - 或者在
main.py开头加：import os; os.setpgrp()，让进程脱离调试器的信号控制组（仅限 Linux 容器） - 更稳妥的做法：在
Dockerfile中用ENTRYPOINT ["sh", "-c"]启动，确保 PID 1 是 shell，再由 shell fork 出 Python —— 这样debugpyattach 到子进程后，父 shell 仍可接收并转发信号 - 避免使用
--wait-for-client+CMD ["python", "-m", "debugpy", ...]组合，它会让debugpy成为 PID 1 并完全接管信号
launch.json 里哪些配置会影响信号传递
launch.json 中看似无关的字段，实际会改变信号路由路径。尤其注意以下三项：
-
"justMyCode": false必须设为false，否则debugpy会拦截更多底层信号（包括SIGUSR1等调试专用信号） -
"console": "integratedTerminal"比"externalTerminal"更容易丢失信号 —— 容器内推荐用"integratedTerminal"但需配合exec启动方式 -
"stopOnEntry": true会让进程在入口处暂停，此时信号可能被挂起，直到你手动 resume —— 建议设为false，除非你真需要首行断点 - 不要在
postCreateCommand里执行pip install debugpy后立即kill -9容器进程，这会导致debugpy的信号 handler 残留，后续 attach 会异常
容器内调试时 SIGTERM 总被忽略的根源
你执行 docker stop myapp 后容器没优雅退出？不是 debugpy 拦截了 SIGTERM，而是 VSCode 的 Dev Containers 扩展在 detach 时会向容器发送 SIGTERM，但若你的 Python 进程不在 PID 1，且没监听 SIGTERM，就会直接被 kernel 强杀。
- 确认你的 Python 主进程确实是 PID 1：
docker exec -it myapp ps -o pid,comm—— 如果看到sh或bash在 PID 1，说明信号发给了 shell，而不是你的 Python - 在代码里显式注册：
signal.signal(signal.SIGTERM, lambda s, f: (cleanup(), exit(0)))，且确保该注册发生在debugpy启动之前 - 如果用了
debugpy.listen(...)+wait_for_client()模式，必须在wait_for_client()返回后再注册信号 handler，否则会被阻塞住 -
docker-compose.yml中设置stop_grace_period: 30s，给 Python 留出清理时间；别依赖debugpy自动处理终止逻辑
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
