简介Oracle SQL Developer 4.0.3.16.84-x64 是 Oracle 官方推出的免费数据库管理工具面向开发人员与数据库管理员尤其适合刚接触 Oracle 的新手快速上手。它提供图形化集成环境可完成数据库连接配置、SQL 编写与执行、表与视图的数据浏览编辑、数据模型设计、报表图表生成、跨库数据迁移、PL/SQL 调试、Git 版本控制集成以及基于 SQL Tuning Advisor 与 AWR 的性能分析等任务覆盖日常开发与运维的主要场景。资源包为 zip 格式共约 2000 个文件整体 312.28MB其中以 jar 库文件、xml 配置、sql 脚本、xslt 样式、exe 可执行程序、dll 动态库及 png 图标资源为主另含少量 html、pdf、properties 等说明与配置文档目录结构完整解压后即可按安装指南部署使用。目前已有 769 人学习下载适合希望系统掌握 Oracle 数据库开发与管理、需要稳定工具环境的中初级开发者参考使用。1. 为什么还有人死磕 sqldeveloper-4.0.3.16.84-x64 这个老版本上周帮一个做金融外包的朋友排查问题他那边内网开发机全是 Windows 7 加 4GB 内存装最新版 Oracle 客户端直接卡死最后翻出一个 2015 年左右的安装包——sqldeveloper-4.0.3.16.84-x64解压即用启动不到 20 秒。这不是怀旧是现实约束下的最优解。这个版本号拆开看4.0.3 是主版本16.84 是构建号x64 表示 64 位 JDK 依赖。它最大的特点是自带 JDK 配置入口、不强制走安装程序、对老 Windows 兼容性好而且连接 Oracle 11g/12c 的 JDBC 驱动已经内置。适合谁内网隔离环境、老系统维护、低配虚拟机、以及需要快速拉起一个 SQL 编辑器的场景。如果你手头只有这个安装包或者公司镜像库里只存了这一个版本那这篇就是写给你的。2. 解压之后先别急着连目录结构与 JDK 绑定关系2.1 四个核心目录到底谁管什么拿到 sqldeveloper-4.0.3.16.84-x64 压缩包解压后你会看到一堆文件夹但真正影响能不能跑起来的只有四个。sqldeveloper是主程序目录里面sqldeveloper.exe是 Windows 启动入口sqldeveloper.conf是配置文件jdev目录是底层 IDE 框架ide目录放的是 bin 和 lib。jdk目录如果是空的说明这个包依赖外部 JDK如果里面有jre或jdk子目录那就是自带运行时。bin目录里通常有sqldeveloper.sh和sqldeveloper.exe的快捷方式。network目录管的是监听和代理配置一般用不到但内网环境如果配了防火墙白名单需要看network/admin下的tnsnames.ora是否存在。我一般会先确认一件事这个包是“带 JDK 版”还是“裸包版”。带 JDK 的包解压后jdk目录下会有jre文件夹大小在 150MB 以上裸包只有几十 MB启动时会去找系统环境变量JAVA_HOME。4.0.3 这个版本对 JDK 7 和 JDK 8 都兼容但 JDK 9 以上会报模块化错误这是第一个大坑。2.2 手动指定 JDK 的两种写法如果系统里装了多个 JDK或者JAVA_HOME指向了高版本sqldeveloper 启动会直接闪退连报错窗口都不弹。这时候需要手动改sqldeveloper/bin/sqldeveloper.conf。用文本编辑器打开找到SetJavaHome这一行如果没有就手动加。# 文件路径sqldeveloper/bin/sqldeveloper.conf # 在文件末尾追加以下内容路径替换成你本机 JDK 8 的实际目录 SetJavaHome C:\Java\jdk1.8.0_202 # 如果路径带空格用双引号包起来 # SetJavaHome C:\Program Files\Java\jdk1.8.0_202逻辑说明SetJavaHome是 sqldeveloper 启动脚本读取的变量优先级高于系统环境变量。参数说明路径必须指向 JDK 根目录不是bin目录也不是jre目录。改完之后保存双击sqldeveloper.exe应该能看到启动画面。如果还是闪退去sqldeveloper/bin下找sqldeveloper.log里面会写Unable to find Java或者Unsupported major.minor version前者是路径错后者是 JDK 版本太高。另一种写法是在 Windows 快捷方式里加参数但 4.0.3 的启动器对参数解析不太稳定我一般不用。还有一种情况是公司电脑禁用了SetJavaHome的写入权限那就把整个包放到C:\Users\你的用户名\下避免Program Files的权限拦截。2.3 首次启动必须改的三个内存参数4.0.3 默认给 JVM 分配的内存很小打开一个带几十张表的 schema 就会卡死。改sqldeveloper/bin/sqldeveloper.conf里的AddVMOption系列参数。# 初始堆内存建议设为物理内存的 1/84GB 机器设 512m AddVMOption -Xms512m # 最大堆内存建议不超过 2g再大反而触发 Full GC 频繁 AddVMOption -Xmx1536m # 永久代大小JDK 8 用 Metaspace这行在 4.0.3 里仍然有效 AddVMOption -XX:MaxPermSize256m逻辑说明-Xms和-Xmx设成一样可以避免堆动态扩展带来的卡顿。参数说明MaxPermSize在 JDK 8 里会被忽略但 4.0.3 的启动脚本会检查这个参数是否存在不写可能报 warning。如果机器内存只有 2GB-Xmx设 768m 就够了再大系统会开始用交换分区反而更慢。改完重启在Help - About里能看到当前 JVM 内存确认生效。3. 连上 Oracle 之前JDBC 驱动、TNS 与连接串的三种配法3.1 内置驱动够不够用什么时候要换 ojdbcsqldeveloper-4.0.3.16.84-x64 自带的是ojdbc6.jar或ojdbc7.jar对应 Oracle 11g 和 12c 第一版。如果你连的是 Oracle 19c 或 21c用内置驱动可能报ORA-28040: No matching authentication protocol这是认证协议不匹配。解决办法是去 Oracle 官网下对应版本的ojdbc8.jar然后替换sqldeveloper/jdbc/lib下的旧文件。# 进入 jdbc 库目录 cd sqldeveloper/jdbc/lib # 备份旧驱动 mv ojdbc6.jar ojdbc6.jar.bak # 把新驱动拷进来文件名保持 ojdbc8.jar cp /path/to/ojdbc8.jar . # 修改 sqldeveloper.conf显式指定驱动路径 # 在文件末尾加一行 AddJavaLibFile ../jdbc/lib/ojdbc8.jar逻辑说明AddJavaLibFile告诉启动器优先加载指定 jar避免多个版本冲突。参数说明路径是相对sqldeveloper/bin的所以用../jdbc/lib/。如果换完驱动还是报协议错检查sqldeveloper.conf里有没有AddVMOption -Doracle.jdbc.autoCommitSpecCompliantfalse这行在 4.0.3 里默认没有加上可以兼容老库。3.2 用 TNS 别名连和用主机名直连的区别TNS 别名适合公司有统一tnsnames.ora的情况配置一次到处能用。直连适合临时连测试库不用改文件。4.0.3 的连接窗口里连接类型选TNS还是Basic决定了后面填什么。TNS 方式在sqldeveloper/network/admin下新建tnsnames.ora内容如下。# 文件路径sqldeveloper/network/admin/tnsnames.ora # 别名可以随便起但不要带空格 MYDB (DESCRIPTION (ADDRESS (PROTOCOL TCP)(HOST 192.168.1.100)(PORT 1521)) (CONNECT_DATA (SERVER DEDICATED) (SERVICE_NAME orcl) ) )逻辑说明SERVICE_NAME和SID不一样11g 之后优先用SERVICE_NAME。参数说明HOST写 IP 或域名PORT默认 1521SERVER一般用DEDICATED共享模式在 4.0.3 里支持不好。配完后在 sqldeveloper 里新建连接连接类型选TNS网络别名下拉框里会出现MYDB。Basic 方式连接类型选Basic主机名填 IP端口填 1521SID 或服务名填orcl。注意 4.0.3 的 Basic 模式对服务名和 SID 的区分不敏感但如果你填错报错信息是ORA-12505: TNS:listener does not currently know of SID given in connect descriptor这时候换成服务名再试。3.3 连接串里最容易写错的三个参数第一个是SERVICE_NAME和SID混用。很多老 DBA 习惯写 SID但 12c 之后容器库必须用服务名。第二个是SERVER SHARED4.0.3 连共享模式经常卡在Connecting...改成DEDICATED就好。第三个是字符集如果库是ZHS16GBK客户端NLS_LANG没设对中文会变问号。# 在 sqldeveloper.conf 里加 NLS_LANG 设置 AddVMOption -Duser.languageen AddVMOption -Duser.countryUS # 更直接的方式是设系统环境变量 # Windows 命令行执行 set NLS_LANGSIMPLIFIED CHINESE_CHINA.ZHS16GBK逻辑说明NLS_LANG格式是语言_地区.字符集中间是下划线点和字符集之间没有空格。参数说明如果库是AL32UTF8就设SIMPLIFIED CHINESE_CHINA.AL32UTF8。设完重启 sqldeveloper在Help - Support Info里能看到当前 NLS 设置。4. 避坑4.0.3 在 Win7/Win10 上的五个翻车现场4.1 启动闪退日志里写 “Unable to create Java Virtual Machine”现象双击 exe 后鼠标转两圈进程消失没有任何窗口。原因sqldeveloper.conf里的SetJavaHome指向了一个不存在的路径或者路径里有中文。解决把 JDK 装到纯英文路径下比如C:\Java\jdk1.8.0_202然后确认sqldeveloper/bin/sqldeveloper.conf里SetJavaHome后面没有多余空格。如果还不行把sqldeveloper/bin下的sqldeveloper.exe右键属性兼容性选 Windows 7勾选“以管理员身份运行”。4.2 连上库之后查询中文全是问号现象SELECT 测试 FROM dual返回???。原因客户端 NLS_LANG 和数据库字符集不一致。解决先查库的字符集SELECT * FROM nls_database_parameters WHERE parameterNLS_CHARACTERSET;假设返回ZHS16GBK就在 Windows 环境变量里加NLS_LANGSIMPLIFIED CHINESE_CHINA.ZHS16GBK。注意 sqldeveloper 4.0.3 不会自动读取这个变量需要在sqldeveloper.conf里加AddVMOption -Dfile.encodingGBK然后重启。4.3 执行长 SQL 时界面卡死任务管理器显示 Java 进程 CPU 100%现象跑一个多表关联的查询界面无响应只能强杀。原因默认堆内存太小加上 4.0.3 的 SQL 编辑器没有分页加载。解决把-Xmx调到 2048m然后在工具 - 首选项 - 数据库 - 工作表里把“最大行数”从 500 改成 100勾选“自动提交”关掉。如果还是卡把 SQL 拆成多个 CTE 分步执行别一次性跑完。4.4 导出数据时 CSV 文件打开乱码现象导出 10 万行数据到 CSV用 Excel 打开中文乱码。原因4.0.3 导出默认用 UTF-8 无 BOMExcel 在中文 Windows 下按 GBK 解析。解决导出时选“格式”为CSV然后在首选项 - 数据库 - 导出里把编码改成GBK。如果已经导出了用记事本打开 CSV另存为时编码选ANSI再用 Excel 打开。4.5 安装路径带空格导致 JDBC 驱动加载失败现象把 sqldeveloper 解压到C:\Program Files\sqldeveloper启动时报ClassNotFoundException: oracle.jdbc.OracleDriver。原因启动脚本解析AddJavaLibFile时没有处理路径空格。解决把整个目录移到C:\sqldeveloper或D:\tools\sqldeveloper路径里不要有空格和中文。如果必须放Program Files就在sqldeveloper.conf里用短路径C:\Progra~1\sqldeveloper代替。5. 让 4.0.3 再战三年的四个进阶技巧5.1 用 SQLcl 补上命令行导出的短板sqldeveloper 4.0.3 的图形界面导出大数据量时容易内存溢出我一般会搭配 SQLcl 做命令行导出。SQLcl 是 Oracle 官方提供的命令行工具和 sqldeveloper 共用 JDBC 驱动但内存占用小得多。把 SQLcl 解压到任意目录然后在 sqldeveloper 的“外部工具”里配置一个调用入口。# SQLcl 导出示例在命令行执行 sql /nolog # 连接数据库 conn username/password192.168.1.100:1521/orcl # 设置导出格式 set sqlformat csv # 导出查询结果到文件 spool /path/to/export.csv SELECT * FROM your_table WHERE rownum 100000; spool off exit逻辑说明set sqlformat csv让输出直接是 CSV 格式spool把结果写到文件。参数说明rownum 100000限制行数避免一次性拉太多。如果表很大用WHERE条件分批导出每次 5 万行。SQLcl 的 JDBC 驱动可以复用 sqldeveloper 的ojdbc8.jar在 SQLcl 的bin/sql脚本里改JAVA_HOME和 classpath 即可。5.2 把常用查询存成代码模板4.0.3 支持“代码模板”功能在工具 - 首选项 - 数据库 - SQL 编辑器 - 代码模板里可以加自定义片段。我一般把“查表结构”“查索引”“查执行计划”三个高频操作存进去。模板名称触发词模板内容查表结构descSELECT column_name, data_type, data_length FROM user_tab_columns WHERE table_name UPPER(table);查索引idxSELECT index_name, column_name, uniqueness FROM user_ind_columns WHERE table_name UPPER(table);查执行计划planEXPLAIN PLAN FOR sql; SELECT * FROM TABLE(DBMS_XPLAN.DISPLAY);逻辑说明table和sql是 sqldeveloper 的变量替换语法执行时会弹窗让你输入。参数说明模板触发词不要和 SQL 关键字冲突比如desc在 SQL 里是保留字但作为模板触发词只在编辑器里生效不影响执行。存完之后在 SQL 编辑器里输入desc再按 Tab 键就会自动展开。5.3 用“数据库差异”功能做 schema 比对4.0.3 自带一个“数据库差异”工具在工具 - 数据库差异里打开。选两个连接一个源库一个目标库勾选要对比的对象类型表、索引、约束、权限点“生成差异报告”。这个功能在版本升级或迁移时特别有用能直接生成 DDL 同步脚本。我一般会先对比表结构确认字段类型和长度一致再对比索引和约束。注意 4.0.3 的差异工具对分区表和物化视图支持不完整如果库里有这些对象需要手动检查。生成的脚本不要直接在生产库跑先在一个测试 schema 里验证一遍尤其是DROP和ALTER语句。5.4 定期清理 IDE 缓存避免“玄学”卡顿sqldeveloper 用久了会在用户目录下生成缓存Windows 路径是C:\Users\你的用户名\AppData\Roaming\SQL Developer。这个目录里system4.0.3.16.84文件夹存的是 IDE 配置和临时文件时间长了可能几百 MB导致启动变慢。我一般每个月清一次但注意不要删connections.xml那是保存的连接信息。# 进入缓存目录 cd %APPDATA%\SQL Developer\system4.0.3.16.84 # 删除临时文件和日志保留 connections.xml 和 o.jdeveloper.* 配置 del /q *.log del /q *.tmp # 如果启动特别慢可以删掉整个 system 目录但连接信息会丢 # 删之前先备份 connections.xml copy connections.xml D:\backup\connections.xml逻辑说明system4.0.3.16.84目录下的o.jdeveloper开头的文件夹存的是 IDE 框架配置删了会重置界面布局。参数说明connections.xml在system4.0.3.16.84的上级目录路径是%APPDATA%\SQL Developer\。如果连接信息丢了把备份的connections.xml拷回去重启即可。5.5 一个我用了三年的启动习惯每次重装系统或者换机器我第一件事不是装 sqldeveloper而是先建一个D:\tools\sqldeveloper目录把解压后的文件放进去然后改sqldeveloper.conf里的SetJavaHome和-Xmx最后把tnsnames.ora从旧机器拷过来。这套流程走完从解压到连上库不超过 5 分钟。sqldeveloper-4.0.3.16.84-x64 这个版本虽然老但它的配置文件结构简单没有后来版本那些花哨的插件依赖反而成了内网环境里最稳的选择。如果你也在维护老系统不妨按上面的步骤试一遍遇到闪退先看日志遇到乱码先查 NLS_LANG遇到卡顿先加内存。希望帮到你。本文还有配套的精品资源点击获取
