oracle 23ai向量搜索无法通过spring boot自动配置启动，因spring-boot-starter-jdbc及mybatis、hibernate等orm均不识别vector类型，也不支持vector_distance函数和array绑定。
Oracle 23ai 向量搜索不能靠 Spring Boot 自动配置启动
Spring Boot 的 spring-boot-starter-jdbc 或主流 ORM（如 MyBatis、Hibernate）**完全不识别 VECTOR 类型**，也不会自动注册 Oracle 特有的 VECTOR_DISTANCE 函数或处理 ARRAY 绑定逻辑。试图用 @Query 写 SELECT * FROM t WHERE VECTOR_DISTANCE(v, ?, 'COSINE') 会直接报 ORA-00904 或 ORA-40695——不是 SQL 写错，是驱动层根本没把参数当 VECTOR 解析。
必须手动获取 OracleConnection 并构造 VECTOR ARRAY
Java 端传入向量的核心障碍是：标准 JDBC 的 setObject(1, floatArray, Types.ARRAY) 在 Oracle 23ai 下必然失败。你得走 Oracle 原生路径：
- 从
DataSource获取连接后，立即调用connection.unwrap(OracleConnection.class) - 用
ArrayDescriptor.createDescriptor("VECTOR", connection)创建 descriptor（注意：类型名必须大写"VECTOR"，小写会触发 ORA-40695） - 用
new ARRAY(descriptor, connection, floatArray)构造数组，其中floatArray长度必须与表定义维度严格一致（比如列是VECTOR(384, FLOAT32)，你就只能传长度为 384 的float[]） - 在
PreparedStatement中调用setARRAY(1, array)，而非setObject
SQL 层必须显式声明距离函数和排序方向
Oracle 对向量查询语法极其敏感，常见翻车点：
WHERE VECTOR_DISTANCE(col, ?, 'COSINE') 合法；但 <code>'cosine'（小写）或'cos'会报 ORA-40695-
ORDER BY VECTOR_DISTANCE(col, ?)缺少方向会报 ORA-00907，必须写成ORDER BY VECTOR_DISTANCE(col, ?) ASC或DESC - 不能对 VECTOR 列用
=、LIKE、IN，所有过滤都得靠VECTOR_DISTANCE+ 阈值 - 若查不到结果，先检查
INMEMORY是否启用：ALTER TABLE my_table INMEMORY;，否则退化为全表扫描
连接字符串要加 oracle.net.disableOcm=true
不加这个参数，JDBC 连接池（尤其是 HikariCP）会在高并发下出现连接泄漏，表现为连接数缓慢上涨、最终超时。这不是 Spring Boot 配置能绕过的底层驱动行为：
- 在
spring.datasource.url末尾追加：?oracle.net.disableOcm=true - 不要尝试用
hikari.connection-init-sql或自定义DataSource初始化逻辑来“修复”，它只治标不治本 - 该参数从 Oracle JDBC 23.x 驱动起成为向量场景的强制要求
真正卡住人的地方不在代码行数，而在维度对齐、大小写敏感、INMEMORY 开关这三处——它们不出错时一切正常，一出错就报一堆不相关的 ORA 错误码，得逐条对照日志里实际执行的 SQL 和表定义才能定位。
