GlassFish 应用服务器配置 Oracle 数据源：关键步骤与避坑指南

在 GlassFish 中配置 Oracle 数据源，看似是标准操作，但几个细节没对上，就可能导致连接测试失败或应用运行时抛出令人头疼的异常。下面这份指南，将帮你梳理从驱动部署到 JNDI 绑定的完整流程，并重点指出那些容易踩坑的地方。

确认 Oracle JDBC 驱动已正确部署到 domain/lib

首先，一个常见的误区是认为 GlassFish 会自动管理驱动。实际上，它不会自动加载 ojdbc8.jar 或 ojdbc11.jar 这类驱动包。你必须手动将其放入目标 domain 的 lib/ 目录，否则创建数据源时，经典的 ClassNotFoundException: oracle.jdbc.driver.OracleDriver 就会跳出来，连接测试自然也通不过。

• 路径要找准：通常是 $GLASSFISH_HOME/glassfish/domains/domain1/lib/。别图省事放到 glassfish/lib/ 这个全局目录，除非你确有跨多个 domain 复用驱动的需求，否则极易引发版本冲突。
• 重启才生效：驱动包放进去之后，必须重启整个 domain（使用 asadmin restart-domain 命令）。仅仅刷新管理控制台是没用的。
• 如何验证：登录 Admin Console，依次进入 “Server” → “Ja va” → “JVM Settings” → “JVM Options”。检查一下这里，确保没有重复的 -Xbootclasspath 参数指向旧的驱动版本，以免造成干扰。

在 Admin Console 中配置 JDBC Connection Pool 时的关键参数

数据源的核心是连接池（JDBC Connection Pool）配置，而不是直接创建 JDBC Resource。这里的参数如果配错，轻则连接超时、字符集乱码，重则直接报出 ORA-00604、ORA-12505 等数据库错误。

• Resource Type：务必选择 ja vax.sql.DataSource。除非你明确需要分布式事务支持，否则别选 XADataSource。
• Database Vendor：下拉选择 Oracle。这会让 GlassFish 自动填充一部分默认属性，但千万别完全依赖它，关键参数仍需手动核对。
• URL 格式：这是高频出错点。标准格式应为：jdbc:oracle:thin:@//host:port/service_name。注意其中的双斜杠“//”，以及使用 service_name 而非传统的 SID。如果你的环境仍在使用 SID，格式需调整为：jdbc:oracle:thin:@host:port:SID。
• 账号权限：填写的数据库用户至少需要具备 CREATE SESSION 权限，否则连不上。
• 关键自定义属性：强烈建议添加一个属性：connectionProperties = oracle.jdbc.J2EE13Compliant=true。这个设置能避免在 JTA 事务场景下，连接被意外关闭。

测试连接失败的三个高频原因及对应检查点

配置完点“保存”只是第一步，一定要点击“Ping”测试，看到“Ping Succeeded”才算真正可用。很多连接失败，问题并不在配置本身，而在底层环境。

• 网络连通性：防火墙或安全组策略很可能阻断了 GlassFish 服务器到 Oracle 数据库端口（默认 1521）的通信。最直接的验证方法是，在 GlassFish 所在的服务器上，执行 telnet db-host 1521 命令，看能否连通。
• 监听器服务名：确保你 URL 里写的 service_name 已在 Oracle 监听器中注册。在数据库服务器上，运行 lsnrctl status 命令，查看输出结果是否包含你使用的服务名。
• 连接验证表：这个参数可以留空，但如果填写了（比如常用的 DUAL），必须确认连接所用的数据库用户有查询该表的权限。某些 Oracle 版本或权限配置下，这可能成为隐形障碍。