当 vs code 调试 azure function 应用时，若出现“server [pid=xxx] is already being debugged”提示且调试工具栏缺失、断点失效，本质是调试会话冲突或 attach 模式配置不当所致；本文提供可落地的五步排查与修复方案。
当 vs code 调试 azure function 应用时，若出现“server [pid=xxx] is already being debugged”提示且调试工具栏缺失、断点失效，本质是调试会话冲突或 attach 模式配置不当所致；本文提供可落地的五步排查与修复方案。
在使用 VS Code 调试 Python 编写的 Azure Functions 时，调试工具栏（Debug Toolbar）——即顶部包含「继续」「暂停」「重启」「停止」等按钮的控制条——未正常显示，是最典型也最影响效率的调试异常之一。该问题常伴随 Server [pid=xxx] is already being debugged 报错弹窗，表面看是“已有调试器占用”，实则暴露了底层调试通道未正确接管、会话生命周期管理失序的核心缺陷。
? 根本原因分析
VS Code 的 Python 调试依赖 debugpy 启动远程调试服务，并通过 attach 模式连接 Azure Functions Host（由 func host start 启动）。你当前的 launch.json 配置为纯 attach 模式，但未启用子进程调试支持，导致：
- Azure Functions Host 启动后会 fork 出多个子进程（如函数实例、扩展宿主），而默认
attach仅连接主进程（PID=17388），无法捕获子进程中实际执行函数逻辑的线程； - 工具栏依赖完整调试上下文（包括活动线程、栈帧、变量作用域）渲染，子进程未接入 → 上下文为空 → 工具栏自动隐藏；
- Windows 系统下进程权限隔离更严格，Linux 用户因 WSL 或容器环境天然支持多进程调试，故现象不明显。
✅ 五步精准修复方案
1. 终止残留调试进程（强制清理）
打开 Windows 任务管理器 → 切换到「详细信息」选项卡 → 按 Image Name 排序，查找并结束所有以下进程：
-
func.exe（Azure Functions Core Tools 主进程） -
python.exe/py.exe（含debugpy相关命令行参数，如--listen 9091） -
dotnet.exe（若启用 .NET 集成）⚠️ 注意：不要仅关闭终端窗口，必须彻底终止进程，否则端口
9091仍被占用。
2. 更新 launch.json —— 启用子进程调试
在现有配置中显式添加 "subProcess": true（这是关键修复项），并建议补充超时与路径映射增强稳定性：
{
"version": "0.2.0",
"configurations": [
{
"name": "Attach to Python Functions",
"type": "debugpy",
"request": "attach",
"connect": {
"host": "localhost",
"port": 9091
},
"preLaunchTask": "func: host start",
"justMyCode": false,
"subProcess": true, // ← 必加！启用子进程调试
"timeout": 30, // 防止连接挂起
"pathMappings": [ // 确保源码路径匹配（尤其跨平台）
{
"localRoot": "${workspaceFolder}",
"remoteRoot": "${workspaceFolder}"
}
]
}
]
}
3. 验证并优化预启动任务（preLaunchTask）
确保 .vscode/tasks.json 中 func: host start 任务明确指定 --language-worker --worker-id python 并禁用热重载（避免重复启动 debugpy）：
{
"label": "func: host start",
"type": "shell",
"command": "func host start --language-worker --worker-id python --no-build",
"isBackground": true,
"problemMatcher": "$func-host-start"
}
4. 以管理员权限运行 VS Code（Windows 必做）
右键 VS Code 快捷方式 → 「以管理员身份运行」。原因：Azure Functions Core Tools 在 Windows 下绑定 localhost:9091 可能受 UAC 限制，非管理员权限下 debugpy 无法建立双向通信管道，导致工具栏无法初始化。
5. 替代方案：改用 launch 模式（推荐长期使用）
若 attach 模式持续不稳定，建议切换为更可控的 launch 模式，由 VS Code 全权管理调试生命周期：
{
"name": "Python Function (launch)",
"type": "debugpy",
"request": "launch",
"module": "azure.functions.worker",
"args": ["--host", "localhost:7071", "--worker-id", "python"],
"env": {
"PYTHONPATH": "${workspaceFolder}"
},
"justMyCode": false,
"subProcess": true
}
? 提示：此模式需确保
func host start不再手动运行，完全交由 VS Code 启动。
? 补充注意事项
- 禁用冲突插件：临时停用 GitHub Copilot、Codeium 等 AI 补全插件，其内联建议机制可能劫持调试器输入事件流；
-
检查端口占用：执行
netstat -ano | findstr :9091，确认无其他进程监听该端口； - 升级核心组件：确保已安装最新版 Azure Functions Core Tools v4+ 和 Python Extension for VS Code v2026.10+；
-
WSL 用户特别注意：若在 WSL2 中调试 Windows 主机上的函数，需配置
host为host.docker.internal并开放防火墙端口。
完成上述任一有效步骤后，重新按 F5 启动调试，工具栏将在函数首次触发时立即显示，断点可正常命中，调试体验回归专业开发标准。
