必须先编译带调试信息，再用SQL Developer连接监听器，否则断点永远不生效；需执行ALTER PROCEDURE ... COMPILE DEBUG、启动Debugger Listener（View→Debugger→Start Debugger Listener）、并用匿名块而非EXEC触发调试。
ALTER PROCEDURE ... COMPILE DEBUG 必须手动执行
创建或修改存储过程后，Oracle默认不生成调试符号。哪怕你在SQL Developer里右键“Compile for Debug”，底层也是执行这条语句：ALTER PROCEDURE my_proc COMPILE DEBUG。漏掉这步，所有断点都形同虚设——程序照常跑完，调试器毫无反应。
常见错误现象：断点灰色不可用、点击后无响应、执行时直接跳过不暂停。
实操建议：
• 每次改完存储过程代码，立刻执行ALTER PROCEDURE schema.proc_name COMPILE DEBUG
• 如果提示PLS-00103: Encountered the symbol "DEBUG"，说明数据库参数PLSQL_DEBUG没开，需DBA执行ALTER SYSTEM SET PLSQL_DEBUG=TRUE SCOPE=BOTH
• 不要用CREATE OR REPLACE PROCEDURE ...直接覆盖——它不会自动带DEBUG，必须显式编译
SQL Developer调试前必须启动JDWP监听器
SQL Developer不是开箱即用的调试器。首次调试前，必须手动打开“Debugger”监听器（菜单：View → Debugger → Start Debugger Listener），默认监听localhost:4000。
常见错误现象：点击“Debug”按钮后卡住、弹出“Connection refused”、或根本没进调试模式。
实操建议：
• 监听器端口被占用时，改用其他端口（如4001），并在调试配置里同步修改
• 远程调试需确认防火墙放行该端口，且数据库端REMOTE_LOGIN_PASSWORDFILE=EXCLUSIVE
• 可用匿名块主动连一次验证链路：BEGIN DBMS_DEBUG_JDWP.CONNECT_TCP('localhost', '4000'); END;，成功则返回空白，失败会报ORA错误
调用方式必须用匿名块，不能直接EXEC
在SQL Developer里写EXEC my_proc(10, :out_val)，调试器根本不会介入——它只拦截通过“Debug”按钮触发的匿名块执行。
常见错误现象：过程执行成功，但断点没触发、变量窗口空白、调试工具栏灰掉。
实操建议：
• 调试时一律用标准匿名块：DECLARE v_in NUMBER := 10; v_out NUMBER; BEGIN my_proc(v_in, v_out); END;
• 确保光标落在该块内，再点工具栏的Debug按钮（绿色虫子图标），不是Run（绿色三角）
• OUT参数值只能在调试暂停时查看，运行结束后v_out变量在普通SQL Worksheet里查不到
DBMS_OUTPUT.PUT_LINE 输出需手动开启
即使存储过程里写了DBMS_OUTPUT.PUT_LINE('step 1')，默认也看不到输出——这不是调试器问题，而是会话级开关未打开。
常见错误现象：过程逻辑走到某行，但控制台空空如也，误以为没执行。
实操建议：
• 在SQL Developer中，先执行SET SERVEROUTPUT ON（在同一个Worksheet里）
• 或勾选菜单Tools → Preferences → Database → Advanced → “Display DBMS Output view”
• 注意：输出内容是缓冲的，只有执行完或显式DBMS_OUTPUT.FLUSH才会刷到界面，单步执行时可能滞后显示
COMPILE DEBUG忘了执行、监听器没开、或者用了EXEC而不是匿名块调试——这三个点串不起来，调试就永远在门外。 
