如何在Java中调用Oracle 21c的JavaScript存储过程_使用GraalVM集成驱动-Oracle-PHP中文网

oracle 21c 使用 javascript 存储过程需启用 enable_javascript、使用 21.3+ 版本、jdbc 23.4+ 驱动并配置 oracle.jdbc.javascript=true，调用须通过 dbms_javascript.evaluate/execute 传 js 字符串，参数与返回值仅支持 json 格式。

oracle 21c 的 javascript 存储过程必须启用 graalvm 模式

oracle 21c 默认不启用 javascript 存储过程支持，即使安装了 graalvm 驱动也无效。必须先确认数据库实例已开启 enable_javascript 功能，并且使用的是支持 graalvm 的 oracle home（如 oracle-database-ee:21.3.0-gi 官方镜像或手动配置的 21c ru7+）。

常见错误现象：ORA-00900: invalid SQL statement 或 PLS-00201: identifier 'DBMS_JAVASCRIPT' must be declared —— 这说明 JS 引擎根本没加载。

检查是否启用：SELECT * FROM v$option WHERE parameter = 'JavaScript';，返回 TRUE 才算就绪
若为 FALSE，需 DBA 执行：ALTER SYSTEM SET enable_javascript = TRUE SCOPE=BOTH;，并重启实例
确认数据库版本 ≥ 21.3，低于此版本（如 21.1）虽标称支持，但 CREATE PROCEDURE ... LANGUAGE JAVASCRIPT 语法会报错

Java 端调用需用 Oracle JDBC 23c+ 驱动（非 21c）

Oracle 官方直到 JDBC 23.4 才正式支持通过标准 CallableStatement 调用 JavaScript 存储过程。JDBC 21c/22c 驱动会静默忽略 LANGUAGE JAVASCRIPT 的 PL/SQL 块，或抛出 ORA-22922: nonexistent LOB value 类似异常。

关键点在于：驱动必须识别 DBMS_JAVASCRIPT 内部包并正确序列化 JS 函数参数（尤其是 JSON 对象、数组），旧驱动把它当普通 PL/SQL 处理，导致类型映射失败。

下载地址：ojdbc23.jar（非 ojdbc8.jar 或 ojdbc11.jar）
Maven 依赖写法：<artifactid>ojdbc23</artifactid><version>23.4.0.24.05</version>
连接 URL 必须加 ?oracle.jdbc.javaScript=true 参数，否则驱动跳过 JS 协议协商

调用语法必须绕过 PL/SQL 匿名块，直连 DBMS_JAVASCRIPT

不能像调用 PL/SQL 那样写 {call my_js_proc(?)} —— Oracle 不允许直接注册 JavaScript 过程为可调用对象。真实路径是：通过 DBMS_JAVASCRIPT.EVALUATE 或 DBMS_JAVASCRIPT.EXECUTE 传入 JS 源码字符串 + 参数绑定。

JavaStoryDevelop

你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在

下载

这意味着每次调用都带 JS 代码文本，不适合高频场景，但能规避权限和部署问题。

最简可行示例：

String jsCode = "function hello(name) { return 'Hello, ' + name; } hello(?)";<br>CallableStatement cs = conn.prepareCall("BEGIN ? := DBMS_JAVASCRIPT.EVALUATE(?); END;");<br>cs.registerOutParameter(1, Types.VARCHAR);<br>cs.setString(2, jsCode);<br>cs.setString(3, "Alice"); // 绑定参数<br>cs.execute();<br>String result = cs.getString(1); // → "Hello, Alice"

EVALUATE 用于有返回值的函数；EXECUTE 用于无返回的脚本（如修改表）
JS 中不能访问 java.* 包，GraalVM 沙箱默认禁用 Java 互操作，除非 DBA 显式授予权限：GRANT JAVAUSERPRIV TO your_user;

参数传递限制多，JSON 是唯一可靠方式

JavaScript 存储过程不支持 Oracle 原生类型（如 NUMBER, DATE, REF CURSOR）直接传入。所有输入必须转成 JSON 字符串，JS 侧用 JSON.parse() 解析；返回值也必须 JSON.stringify() 后传出。

试图传 java.sql.Date 或 BigDecimal 会触发 ORA-22922 或 ORA-06553: PLS-306: wrong number or types of arguments。

Java 端构造参数：String jsonInput = new ObjectMapper().writeValueAsString(Map.of("id", 123, "active", true));
JS 侧接收：const input = JSON.parse($1); console.log(input.id);
返回 JSON：return JSON.stringify({ status: "ok", data: [1,2,3] });
注意：JS 中 Date 对象会被序列化为 ISO 字符串，Java 端需用 Instant.parse() 解析

真正麻烦的不是调用本身，而是 JS 里没法直接查表或调用 SQL —— 它只能靠 DBMS_JAVASCRIPT 提供的极简 API（仅 executeQuery 和 executeUpdate，且不支持绑定变量）。业务逻辑稍复杂就得退回到 PL/SQL 封装层。