简介Oracle SQL Developer 4.0.3.16.84-x64 是一款由 Oracle 公司推出的免费数据库管理工具主要面向开发人员与数据库管理员提供从连接、查询、编辑到建模、迁移、调优的一体化工作台。压缩包共包含 2000 个文件以 1066 个 jar 库、802 个 xml 配置、133 个 sql 脚本、96 个 xslt、74 个 exe、64 个 dll 等为主要构成分别对应程序核心、界面设置、数据库操作脚本、样式转换与可执行组件整体约 312.28MB解压后即得完整的 64 位工具环境。包内还包含 png 图标、html 帮助文档、properties 配置、plb 存储过程库文件等资源结构清晰完整。该版本内置数据库连接向导、SQL 编辑器语法高亮/自动补全、数据网格直接编辑、数据模型设计器、数据迁移工具、PL/SQL 调试器、AWR 性能报告查看及版本控制集成适合新手快速上手也能满足日常开发与库管工作。目前已有 770 人学习/下载对于需要本地搭建 Oracle 客户端环境的用户而言这份官方版本可免去逐个收集依赖的麻烦直接获得可运行的完整工具。1. 16.84 这个老版本为什么还在用很多还在维护 Oracle 10g/11g 的团队办公电脑上装的往往不是新版 SQL Developer而是 4.0.3.16.84 这个 x64 老版本。原因很直白它启动快、界面简单连老库时几乎不用折腾 JDBC 驱动打开就能做查询和导出。这份资源是一个绿色解压包定位就是解决低配机器 老版本 Oracle 数据库 database场景下的日常操作适合 DBA、运维、写报表 SQL 的开发人员。它和 Oracle 数据库 database 的连接逻辑与新版一致但资源占用小一个量级这就是它到今天还没被换掉的原因。下面把安装、连接、踩坑和高效用法逐个过一遍。2. 安装与连接配置JDK 版本、conf 文件与首次连库的四个参数2.1 为什么 4.0.3 对 JDK 版本敏感SQL Developer 是 Java 写的应用4.0.3.16.84 这个版本号对应的正好是 JDK 7/8 时代的产物。它本身没有独立打包运行时全靠系统或配置文件里的 JDK 环境来跑。如果 JDK 版本过高最常见的结果就是双击图标后进程一闪而过或者直接进入一个空白窗口然后卡死。我先说结论这个版本跑在 JDK 1.8 上最稳具体到 8u201 之前的更新包基本没出过问题。JDK 9 以上运行 4.0.3 会抛 UnsupportedClassVersionError很多人的第一反应是去重装 Java其实问题出在 SQL Developer 启动器选错了 JVM。所以拿到这个资源包后第一步不是急着解压而是先确认机器上的 Java 环境java -version echo $JAVA_HOME第一行输出的是当前默认 Java 版本第二行是系统级环境变量。如果版本显示是 9、11、17或者 JAVA_HOME 为空我不建议去改系统环境变量那样会影响机器上其他 Java 程序。更干净的做法是直接在 sqldeveloper.conf 里指定一个固定 JDK 路径让启动器忽略系统默认值。参数说明java -version能看到版本号、构建号、运行模式输出里带1.8.0_201就是 JDK 8带9.x或11.0.x就要注意了。$JAVA_HOME在 Windows 的 cmd 里不识别要用echo %JAVA_HOME%。macOS/Linux 用上面这个写法即可。这个环境变量决定了很多 Java 程序的运行基线。如果机器上没有合适的 JDK那就下载一个 JDK 8 的压缩包解压到任意目录不需要安装下一步直接把路径写进配置。2.2 解压路径与 sqldeveloper.conf 配置这个资源是 zip 包解压时有个容易被忽略的细节绝对路径里不要带空格和中文。比如C:\Program Files\sqldeveloper或D:\工具\sqldeveloper这类路径在启动器解析时经常出现找不到模块的问题表现是启动时报错或者界面按钮点击无响应。我一般习惯放在D:\oracle\sqldeveloper这类纯英文路径下。解压完成后进入sqldeveloper/sqldeveloper/bin/目录找到sqldeveloper.conf文件这是整个工具的核心配置文件。用记事本打开后重点看这三行SetJavaHome D:/oracle/jdk1.8.0_201 AddVMOption -Xmx1024M AddVMOption -Dfile.encodingUTF-8逻辑说明SetJavaHome指定 JDK 根目录注意是 JDK 不是 JRE。JDK 目录下应该有bin、lib、include这些子目录填到bin的上一级。如果指向 JRE启动器可能会找不到编译器相关的类导致初始化失败。AddVMOption -Xmx1024M是堆内存上限。默认 256M 在查询大表、打开大结果集的时候很容易报 OutOfMemoryError。机器内存 8G 以上可以加到 2048M但别无脑加SQL Developer 本身是 32 位/64 位取决于系统堆开太大反而会拖慢整个系统。AddVMOption -Dfile.encodingUTF-8这一行原版没有是我自己加的。Windows 中文环境下不加它SQL 里的中文注释、导出文件名经常会变成乱码。参数说明配置项作用建议值SetJavaHome强制指定 JDK 路径绕过系统默认 Java指向 JDK 8 根目录AddVMOption -Xmx设置 JVM 最大堆内存1024M 起步大查询场景 2048MAddVMOption -Dfile.encoding设置文件读写编码UTF-8解决中文乱码保存 conf 文件后再双击sqldeveloper.exe启动。如果依然启动失败回到 2.1 检查 SetJavaHome 路径是否真实存在、路径分隔符用正斜杠还是反斜杠——Windows 下两者都认但正斜杠更不容易被转义出问题。2.3 首次连接 Oracle 数据库的四个参数启动成功后点击左上角绿色加号新建连接会弹出一个连接配置窗口。填写的字段看着多真正决定能否连上的就四个主机名、端口、用户名、服务名。连接类型默认是 Basic这时要填的是主机名数据库服务器 IP 或主机名端口默认 1521除非监听配置改过SID 或 Service Name这是最容易填错的地方用户名/密码数据库账号密码SID 和 Service Name 的区别很实际SID 是实例的唯一标识Service Name 是监听对外提供的数据库服务名。老库 DBA 习惯给 SID新库和 RAC 环境基本用 Service Name。填错了报的错不一样SID 填到 Service Name 位置报 ORA-12505监听器无法处理请求通常是服务名没配对。Service Name 填到 SID 位置报 ORA-12514TNS 监听器无法识别连接描述符中请求的服务。如果拿不准数据库到底是哪种我一般先用 SQL*Plus 做一次直连验证把 SQL Developer 的配置因素排除掉sqlplus system/你的密码//192.168.1.10:1521/ORCL这个写法的格式是用户/密码//主机:端口/服务名走的是 Service Name 方式。如果 SQLPlus 能连上说明监听和数据库网络层没问题再回 SQL Developer 里照着填。SQLPlus 也报 ORA-12514就去问 DBA 拿准确的 SERVICE_NAME 或 SID。逻辑说明SQL*Plus 是 Oracle 自带的字符界面客户端用它做连通性测试的好处是它不依赖图形界面的任何配置出错信息也更贴近原始错误码。SQL Developer 连接失败时经常把真实原因包一层无法使用指定的连接池绕开这层最好的办法就是先在命令行验证。2.4 TNS 方式与直连方式怎么选SQL Developer 4.0.3 的连接类型里除了 Basic还有 TNS。选 TNS 时连接名位置会变成一个下拉框里面列出 tnsnames.ora 文件里定义的所有别名。tnsnames.ora 通常位于$ORACLE_HOME/network/admin/tnsnames.ora或D:\oracle\product\11.2.0\client\network\admin。没有 Oracle 客户端机器的也可以直接把别人发来的 tnsnames.ora 放到任意目录然后在 SQL Developer 的工具 - 首选项 - 数据库 - 高级里指定该文件路径。一份典型的 tnsnames.ora 条目长这样ORCL (DESCRIPTION (ADDRESS_LIST (ADDRESS (PROTOCOL TCP)(HOST 192.168.1.10)(PORT 1521)) ) (CONNECT_DATA (SERVER DEDICATED) (SERVICE_NAME ORCL) ) )这块配置的解读ORCL 是连接别名SQL Developer 下拉框里看到的名字。HOST 192.168.1.10数据库服务器地址主机名也可以。PORT 1521监听端口。SERVICE_NAME ORCL告诉监听要找哪个服务有些老库这里写SID orcl。我的建议是日常办公机器上用 TNS 方式因为团队里库多、环境多DBA 更新一个 tnsnames.ora 文件所有人刷新下拉框就能连新库。临时连一个不在文件里的库用 Basic 方式直连更快不用去改 tnsnames.ora。这里有个绕不开的坑TNS 方式连接时如果 tnsnames.ora 里配的是SID而 SQL Developer 4.0.3 默认按 Service Name 解析就会报 3.3 节要讲的 ORA-12514。后面避坑章节还会展开。3. 避坑启动失败、连接超时、乱码本版五大实录3.1 双击没反应进程一闪而过现象双击 sqldeveloper.exe鼠标转两圈后没有任何窗口出现任务管理器里能看到 javaw.exe 闪一下就消失。原因绝大多数情况是 sqldeveloper.conf 里 SetJavaHome 指向的 JDK 不存在或者指向了 JRE 目录。另一个常见原因是 JDK 版本过高启动器加载类时直接抛出 UnsupportedClassVersionError错误信息还没来得及显示窗口就退了。解决用命令行方式启动一次让错误信息停在屏幕上。在 sqldeveloper 的 bin 目录下按住 Shift 键右键打开 PowerShell 或 cmd执行sqldeveloper.exe这次错误信息会直接打印在当前窗口。如果看到Could not find the main class去检查 SetJavaHome 路径。如果看到版本号不支持换成 8u201 左右的 JDK。从那以后我每次解压新版工具都先跑一次命令行启动不直接双击图标。3.2 中文注释和中文别名乱码现象SQL 窗口里的中文注释显示成问号或者一堆菱形方块导出 CSV 文件用记事本打开正常用 Excel 打开乱码。原因SQL Developer 4.0.3 在 Windows 中文区域设置下默认文件编码走的是本地 ANSI 码页GBK但它读取 SQL 文件时又按 UTF-8 解析两边对不上就乱。数据库里的中文显示乱码则是另一个原因客户端 NLS_LANG 和数据库字符集不一致。解决分两层处理。显示层在 sqldeveloper.conf 里加AddVMOption -Dfile.encodingUTF-8然后重启。数据层在连接属性的高级设置里把 NLS_LANG 参数环境变量改成 AMERICAN_AMERICA.AL32UTF8或者按照数据库实际字符集设置。检查数据库字符集用这条 SQLSELECT value$ FROM sys.props$ WHERE name NLS_CHARACTERSET;如果查出来是 AL32UTF8客户端 NLS_LANG 就用上面的值。如果是 ZHS16GBK就改成 SIMPLIFIED CHINESE_CHINA.ZHS16GBK别硬套 UTF-8。3.3 ORA-12514监听器无法识别请求的服务现象连接测试弹窗报ORA-12514: TNS:listener does not currently know of service requested in connect descriptor或者 ORA-12505 提示 SID 不存在。原因连接对话框里填写的 Service Name 和数据库真实注册到监听器的服务名不一致。最常见的场景DBA 给的是 SID比如 orcl而在 SQL Developer 的 Basic 连接类型里连接标识符默认被当成 Service Name 传出去监听器查无此服务就会报 12514。反过来如果监听配置的是 Service Name你按 SID 填报 12505。解决先用最笨的办法确认服务名。登录数据库服务器执行lsnrctl status输出里的Service ORCL has 1 instance(s)这一行双引号里的就是监听器真实注册的服务名。把这个名字原样填回 SQL Developer 的连接标识符。如果 DBA 只给 SID 不给服务名在 SQL Developer 连接类型里选 TNS并保证 tnsnames.ora 里用的是 SID 写法。lsnrctl需要在安装 Oracle 数据库或客户端的机器上执行纯办公机可能没有这个命令那就直接找 DBA 要grep -i sid /etc/oratab或show parameter service_name的输出结果。3.4 大结果集导出时内存溢出现象查询返回几十万行数据网格里显示没问题点右键导出跑到一半报java.lang.OutOfMemoryError: Java heap space刚才查出来的数据也丢了。原因SQL Developer 的导出操作会把查询结果先完整读取到 JVM 堆里再统一格式化成目标文件。默认堆只有 256M几十万行加几个大字段很容易撑爆。这不是工具 bug是 JVM 参数没调。解决改 sqldeveloper.conf 里的 -Xmx从默认值提到 2048MAddVMOption -Xmx2048M改完后如果还报错说明单次查询结果集太大换成分页导出或加 WHERE 条件分段拉取。另外导出时选择当前页而不是所有行可以显著减少内存占用。血泪经验几百兆数据的导出任务别让结果集一次全加载SQL Developer 不是数据迁移工具干这种活用 SQL*Plus 加 SPOOL 更稳。3.5 高版本数据库连不上或功能异常现象用 4.0.3 连 Oracle 12c 或 19c 数据库连接能建立但查数据字典视图报错或者执行某些 SQL 提示缺少对象。原因4.0.3.16.84 内置的 JDBC 驱动是旧版对 12c 之后新增的数据字典视图和类型支持不完整。比如 12c 的可插拔数据库架构老驱动可能无法正确识别服务名对应的容器。解决最简单的办法是到这个资源的驱动目录里替换 JDBC 驱动把新版驱动放到sqldeveloper/sqldeveloper/lib/下然后删除或改名旧的 ojdbc6.jar。注意新驱动可能是 ojdbc8.jar需要确认版本兼容。另一个办法是连接 12c 数据库时用低权限账号而非 DBA 账号绕过一部分字典权限检查。如果项目本身已经用新版 SQL Developer那这台机器保留 4.0.3 只用来连老库新旧两个版本共存不冲突解压目录分开就行。4. 日常操作落到参数SQL 执行、数据导出与 PL/SQL 调试4.1 SQL 工作表的执行方式与快捷键SQL Developer 里的执行区域叫 SQL Worksheet这个组件的核心操作快捷键需要形成肌肉记忆CtrlEnter执行当前光标所在的那一条 SQL结果呈现在下方结果集。F5执行整个脚本窗口所有 SQL适合建表、建过程、批量语句顺序执行。Ctrl/和CtrlShift/注释/取消注释选中的代码块。CtrlE打开执行计划窗口看 SQL 走了什么访问路径。我用得最多的是执行计划。一条写得很差的报表 SQL往往在 dba_tables 大表关联的场景下能跑几分钟。看执行计划时重点看 Cost 最高的那一步以及有没有出现 FULL TABLE SCAN。一段典型的大表查询加上优化提示在 4.0.3 里的写法SELECT /* PARALLEL(4) */ t.owner, t.table_name, t.num_rows FROM dba_tables t WHERE t.owner NOT IN (SYS, SYSTEM) ORDER BY t.num_rows DESC FETCH FIRST 100 ROWS ONLY;逻辑说明PARALLEL(4)是提示优化器对这个查询开启 4 并行的并行度适合服务器 CPU 核心数足够的场景开发库并发大时别乱用容易把 CPU 打满。FETCH FIRST 100 ROWS ONLY是 12c 以后的分页语法这条语句本身在 4.0.3 里可能因为 JDBC 驱动旧而解析失败那就退回 ROWNUM 写法SELECT * FROM ( SELECT t.* FROM dba_tables t ORDER BY t.num_rows DESC ) WHERE ROWNUM 100;老驱动下用 ROWNUM 更保险。执行计划窗口里如果看到TABLE ACCESS FULL发生在 DBA_TABLES 这种大视图上优先考虑加谓词过滤而不是去改并行度。4.2 把查询结果导出成 INSERT 脚本或 CSV导出功能我是用得最多的尤其是把 A 环境的数据抽出来灌到 B 环境做联调。SQL Developer 4.0.3 的导出向导入口在结果集区域右键 - 导出弹窗里第一个要选的是格式类型。常用格式有delimited文本分隔格格式就是 CSV选择分隔符、行终止符、是否包含列名。insert生成 INSERT 语句每行数据一条适合小表数据迁移。loaderSQL*Loader 控制文件格式大批量装载时用。xlsx直接出 Excel 文件注意老版本对 xlsx 的支持实际上是生成 XML 表格再封装大表会慢。导出一份生产库小字典表的 INSERT 脚本典型配置格式insert 包含列名、表名、带引号字符串、日期格式 日期格式yyyy-mm-dd hh24:mi:ss 每 INSERT 语句行数1这里有个容易翻车的点日期字段默认导出格式依赖客户端 NLS 设置如果不显式指定导出的日期可能是13-11月-24这种依赖中文环境的格式换个环境再跑 SQL 就报 ORA-01861 文字与格式字符串不匹配。所以我在导出向导的日期格式里固定写yyyy-mm-dd hh24:mi:ss虽然啰嗦但目标库无论 NLS 怎么设置都不会出错。CSV 导出同样有编码坑导出时选 UTF-8文件头带上 UTF-8 BOMExcel 打开才不会乱码。4.0.3 导出对话框里没有直接选 BOM 的选项只能在 3.2 节提到的 conf 里加编码参数解决。4.3 PL/SQL 调试的前提条件与基本步骤用 SQL Developer 调试存储过程不是装好工具就能点。数据库账号需要两个权限DEBUG CONNECT SESSION允许调试会话建立连接。DEBUG ANY PROCEDURE允许调试任意存储过程。普通业务账号往往没有这两个权限找 DBA 执行授权GRANT DEBUG CONNECT SESSION TO your_user; GRANT DEBUG ANY PROCEDURE TO your_user;授权完成后在 SQL Developer 左边连接树里展开你的用户 - 过程找到要调试的存储过程右键 - Debug。第一次调试会提示编译选Debug而不是Compile这样会以调试模式重新编译。写一个最小可调的过程做验证CREATE OR REPLACE PROCEDURE p_debug_test IS v_cnt NUMBER; v_owner VARCHAR2(30) : SCOTT; BEGIN SELECT COUNT(*) INTO v_cnt FROM all_tables WHERE owner v_owner; DBMS_OUTPUT.PUT_LINE(owner || v_owner || , tables || v_cnt); END; /逻辑说明这段过程在all_tables里统计指定用户的表数量然后输出。断点打在SELECT COUNT(*)那一行调试运行时可以逐行观察 v_cnt 在被赋值前是 NULL赋值后才是数字。观察窗口对 NUMBER 类型显示比较友好VARCHAR2 在中文环境下偶尔会有显示截断不影响实际值。坑在于如果过程是在生产库上调试每次以 Debug 模式编译都会使同义词依赖失效几秒高并发时段会产生 ORA-04068 错误。我一般只在测试库上调试生产库只做只读查询。5. 多环境连接管理生产与测试环境的识别与切换小技巧连接一多最怕的是本想在测试库上跑 DDL结果连的是生产库。SQL Developer 4.0.3 提供了一个连接颜色标记功能我把它当成默认习惯来用。在左侧连接树里右键某个连接 - 属性弹出的界面里有一个颜色选项。我会把所有生产库连接设为红色测试库设为绿色开发库设为蓝色。一旦连接建立SQL Developer 的窗口顶部和底部状态栏会出现对应颜色的横条非常显眼。配套的管理习惯是连接命名规范。比如生产库prod_orcl_192.168.10.20测试库test_orcl_192.168.10.30开发库dev_orcl_192.168.10.40名字里带上环境和 IP窗口标题栏就会完整显示这些信息。执行任何 DDL 之前先看一眼标题栏确认不是红色横条再动手。这个动作成本极低但能避免大量事故。保存的连接还可以导入导出方便团队里共享。入口在工具 - 首选项 - 数据库 - 连接选择导出的文件格式是 XML内容包含连接名、主机、端口、用户名密码不会导出。用这个文件新同事可以在五分钟内配好和三四个环境一致的连接列表不用挨个手填。换工作目录或重装系统时直接把sqldeveloper/sqldeveloper/下的system目录备份里面存着所有连接配置、窗口布局、首选项。重装后覆盖回去整个工具的体感完全恢复省掉重新配置的时间。最后说一个具体的验证方法任何时候拿不准某个连接连的是哪个库直接执行一条带 DB 信息的 SQLSELECT SYS_CONTEXT(USERENV, DB_NAME) AS db_name, SYS_CONTEXT(USERENV, INSTANCE_NAME) AS instance_name, SYS_CONTEXT(USERENV, SERVER_HOST) AS host FROM dual;返回结果里 DB_NAME 和生产库的 DBID 对不上说明连接走错了环境立刻断开换连接。从那以后我每次在 SQL Developer 里敲下 DELETE 或 DROP 这类高危语句之前都强制自己看一眼窗口顶部连接名加颜色条绿色才执行红色一律先复制到本地再对着测试库改。这个习惯帮我躲过至少三次误操作。这份老版本的绿色包虽然界面朴素但把连接管理和只读查询这些日常动作做顺了比什么都重要希望帮到你。本文还有配套的精品资源点击获取