PostgreSQL断点不命中的首要原因是未安装pldbgapi扩展，必须在目标数据库中执行CREATE EXTENSION pldbgapi;，并确保用户具备EXECUTE权限及DBeaver启用调试支持。
pldbgapi 扩展没装，断点就永远不命中——这是 PostgreSQL 用户调试失败的第一原因。
PostgreSQL 断点不命中的硬性前提
不是所有 PostgreSQL 版本和部署都默认支持调试。DBeaver 的存储过程调试完全依赖服务端的 pldbgapi 扩展，它由 PostgreSQL 官方提供，但需手动启用：
-
CREATE EXTENSION pldbgapi;必须在目标数据库中执行（不是 template1，也不是其他库） - 当前连接用户必须有
EXECUTE权限 onpldbg_attach(integer)等关键函数（仅GRANT ALL ON DATABASE不够） - 验证是否就绪：
SELECT * FROM pldbg_get_proxy_info();能返回两行结果才算通 - DBeaver 连接配置里要勾选“启用调试支持”（在连接编辑器 → 驱动属性 → advanced 页签中找
enableDebug并设为true）
断点打上了，但右键没“调试”菜单？
这不是 UI 延迟，是功能被显式禁用。DBeaver 社区版默认关闭调试特性，哪怕插件已安装：
- 进入 工具 → 设置 → 应用特性（Features）
- 搜索关键词
debug，找到名为Procedure debugger的特性 - 勾选它，点击应用并重启 DBeaver（不是刷新）
- 重启后，右键存储过程才可能出现“调试”项；F11 也才生效
调试启动后卡在“等待附加”，其实是没触发执行
很多人误以为“点调试 = 立刻暂停”，其实 DBeaver 是先向服务端注册监听，等真实调用发生才拦截。典型错误流程：
- 在对象树里右键存储过程 → 点“调试” → 界面卡在“Attaching to procedure…”
- 此时你没做任何事，只是挂了监听，还没跑过程
- 必须另起一个 SQL 编辑器窗口，手动执行：
CALL your_procedure_name(...);或SELECT * FROM your_function_name(...); - 执行语句一发过去，断点立刻命中，调试透视图自动弹出
变量面板空、值显示 <not available></not>？检查作用域和类型
不是所有变量都能实时读取。PostgreSQL 的 PL/pgSQL 变量在调试时受作用域和类型限制：
- 只显示当前栈帧里的局部变量和输入参数，全局临时表或
EXECUTE动态 SQL 中定义的变量不可见 -
RECORD、JSONB、大对象（BYTEA）可能只显示类型名，不展开内容；双击变量名可尝试强制求值 - 如果某行刚声明变量但尚未赋值，它的值就是
NULL，面板不会报错，但容易误判为“没读到” - 条件断点里写的表达式，必须是服务端能直接解析的 PL/pgSQL 表达式，比如
user_id = 10086可以，current_setting('app.env')可能失败
真正卡住的地方，往往不在操作步骤，而在「谁在调用」和「在哪执行」这两个动作没分清：附加是监听，执行是触发。漏掉后者，整个调试链就断在第一步。
