WSO2 OData服务Oracle自增主键类型无法识别导致创建报错求助

问题 #

使用WSO2 OData服务对接Oracle数据库执行CRUD操作时，更新、读取、删除功能均正常，但创建记录时出现异常：

• 记录已成功插入数据库，但接口返回500错误
• 请求体不传入通过序列实现自动递增的数值类型主键ID时触发报错；手动传入ID值则创建操作返回201成功响应

报错日志如下：

[2023-11-24 09:19:42,880] ERROR {ODataAdapter} - Error occurred. :Cannot invoke "org.apache.olingo.commons.api.data.Property.getType()" because the return value of "org.apache.olingo.commons.api.data.Entity.getProperty(String)" is null java.lang.NullPointerException: Cannot invoke "org.apache.olingo.commons.api.data.Property.getType()" because the return value of "org.apache.olingo.commons.api.data.Entity.getProperty(String)" is null
2023-11-24 16:19:42 at org.wso2.micro.integrator.dataservices.core.odata.ODataUtils.buildLocation(ODataUtils.java:91)
2023-11-24 16:19:42 at org.wso2.micro.integrator.dataservices.core.odata.ODataAdapter.createEntity(ODataAdapter.java:594)
2023-11-24 16:19:42 at org.apache.olingo.server.core.requests.DataRequest$EntityRequest.execute(DataRequest.java:370)
2023-11-24 16:19:42 at org.apache.olingo.server.core.requests.DataRequest.execute(DataRequest.java:247)
2023-11-24 16:19:42 at org.apache.olingo.server.core.ServiceDispatcher.internalExecute(ServiceDispatcher.java:166)
2023-11-24 16:19:42 at org.apache.olingo.server.core.ServiceDispatcher.execute(ServiceDispatcher.java:97)
2023-11-24 16:19:42 at org.apache.olingo.server.core.OData4HttpHandler.process(OData4HttpHandler.java:67)
2023-11-24 16:19:42 at org.wso2.micro.integrator.dataservices.core.odata.ODataServiceHandler.process(ODataServiceHandler.java:80)
2023-11-24 16:19:42 at org.wso2.micro.integrator.dataservices.odata.endpoint.ODataEndpoint.lambda$process$0(ODataEndpoint.java:104)
2023-11-24 16:19:42 at java.base/java.lang.Thread.run(Thread.java:833)

当前环境：

• Oracle驱动：ojdbc11.jar（thin类型）
• WSO2 MI版本：4.2.0

绕过方法 #

方法1：配置SQL返回自动生成的主键 #

修改数据服务的创建操作SQL，通过Oracle的RETURNING子句获取序列生成的ID，确保OData服务能拿到主键值：

1. 编写插入SQL时添加返回逻辑：

INSERT INTO YOUR_TABLE (COLUMN1, COLUMN2) VALUES (?, ?) RETURNING ID INTO ?

2. 在数据服务的操作定义中，将返回的ID配置为输出参数，并在OData元数据里标记主键字段为自动生成，让OData服务在创建后能获取到生成的ID，避免空指针异常。

方法2：中介流预处理注入临时ID #

通过WSO2 MI的中介流对请求做预处理，既满足OData对主键存在性的要求，又不影响数据库序列生成逻辑：

1. 在OData端点前添加中介逻辑，检查请求体是否包含ID字段
2. 若不存在ID，自动生成一个临时数值（如当前时间戳）注入请求体
3. 在数据服务的插入SQL中，强制使用序列值填充ID，忽略传入的临时ID，例如：

INSERT INTO YOUR_TABLE (ID, COLUMN1, COLUMN2) VALUES (YOUR_SEQ.NEXTVAL, ?, ?)

方法3：自定义OData工具类（进阶） #

针对ODataUtils.buildLocation方法的空指针问题，自定义扩展类覆盖原逻辑：

1. 编写类继承原ODataUtils，重写buildLocation方法，增加主键属性为空的判断逻辑，当主键不存在时，直接查询数据库获取最新生成的ID
2. 将自定义类打包为JAR，放置到WSO2 MI的lib目录下，通过类加载优先级让系统加载自定义类

内容的提问来源于stack exchange，提问作者Chu UThouArt