📢 【三方库】ohos_dataorm v2.3.8 鸿蒙平台稳定性与质量提升

ohos_dataorm v2.3.8 已发布。本次升级聚焦该库稳定性与质量提升，修复自动迁移与查询拼接等多项缺陷，兼容升级，开发者无需修改现有代码即可享受本次改进。推荐所有该库用户升级至本版本。

版本概览

稳定性提升

修复 ToMany 关系未找到时的空指针问题 [#183]

问题：执行 ToMany 关联查询时，若目标关系未找到（返回 null），代码直接对 null 结果读取属性，导致空指针异常。

修复：在 WhereCollector 查询逻辑中新增 null 保护，关系未找到时返回空集合而非继续访问 null 对象，避免空指针崩溃。

增强 readEntity 代码健壮性 [#183]

问题：readEntity 在反序列化数据库记录为实体对象时，对异常数据的健壮性不足，部分边界场景下可能产生不可预期的行为。

修复：增强 BaseDao 中 readEntity 相关逻辑的健壮性，对字段类型与空值增加校验。

修复自动迁移异常问题 [#186]

问题：自动迁移（AutoMigrate）流程在特定场景下抛出异常，导致数据库升级失败。

修复：重构 BaseDao 自动迁移相关逻辑（99 行改动），修复迁移异常；同时补充 MigrationTestAuto demo 页面与 AutoMigrationScenarioTest XTS 测试用例（共 1133 行新增），覆盖自动迁移场景。

质量提升

修复 setAutoMigrate 赋值错误 [#183]

修复 setAutoMigrate 中版本号赋值逻辑错误，确保迁移流程使用正确的版本参数。

修复 inSql / notInSql 拼接失效问题 [#183]

修复 QueryBuilder 中 inSql 与 notInSql 方法的 SQL 拼接逻辑，此前拼接结果未生效导致条件被忽略。

完善 README 文档说明与示例 [#185]

在 README.md 中补充更详细的接口描述与使用示例，降低开发者上手成本。

兼容性说明

• 无 Breaking Changes，API 接口保持不变。
• 本次变更以缺陷修复与健壮性增强为主，现有代码无需修改。
• 从 v2.3.7 起升级至 v2.3.8 均为兼容性升级。

升级方式

• 鸿蒙原生：oh-package.json5 → "@ohos/dataorm": "^2.3.8"，执行 ohpm install。

相关链接

• 文档：https://gitcode.com/CPF-ApplicationTPC/ohos_dataorm/blob/master/README.md
• CHANGELOG：https://gitcode.com/CPF-ApplicationTPC/ohos_dataorm/blob/master/CHANGELOG.md
• 反馈：https://gitcode.com/CPF-ApplicationTPC/ohos_dataorm/issues