Skip to content

fix(gb28181): 级联录像查询(RecordInfo)响应支持按每页数量分页 - #2242

Merged
648540858 merged 1 commit into
648540858:masterfrom
CieveMe:fix/2138-record-info-paging
Oct 20, 2026
Merged

648540858 merged 1 commit into
648540858:masterfrom
CieveMe:fix/2138-record-info-paging

Conversation

@CieveMe

@CieveMe CieveMe commented Sep 26, 2026 •

Copy link
Copy Markdown
Contributor

关联议题:#2138(作为下级平台,上级查询录像的结果太大,返回时没有分页,超过 MTU 导致上级收不到)

维护者在议题中已明确支持该方向:

ok, 我明白了,我支持下分页回复。增加每页数量的配置。

问题

本服务作为下级平台被上级平台查询录像(CmdType=RecordInfo)时,把整批录像记录拼成一条 SIP MESSAGE 直接回复给上级。记录条数多时,该报文体随条数线性增长,一旦超过链路 MTU(UDP 场景尤其明显),上级就收不到查询结果;当前也没有"每页数量"这样的配置项可以规避。

根因

SIPCommanderForPlatform.recordInfo(...):

  1. 把 recordInfo.getRecordList() 里的全部记录写进同一个 <RecordList Num="N">;
  2. 只调用一次 headerProviderPlatformProvider.createMessageRequest(...) + sipSender.transmitRequest(...)。

调用它的两条支路(国标设备的录像查询回调、云端录像 playService.queryRecord 回调)都无法影响这个"一次发完"的行为,因此只要记录足够多就必然超 MTU。

改动范围

  1. 新增配置 user-settings.record-info-page-size → UserSetting.recordInfoPageSize
    • > 0:单条 SIP MESSAGE 最多携带这么多条记录,超出部分按多页顺序发送(SN 不变、SumNum 仍为总条数、每页 <RecordList Num="本页条数">,便于上级按 SN 聚合);
    • <= 0:不分页,一次发送全部,与历史行为一致;
    • 默认值 1000(足够大):常规部署的单条报文与今天完全一致,不改变现有行为;只有超过 1000 条的查询才会分页——而那种查询在当前版本本来就是失败的。
    • 你说要"增加每页数量的配置"——我这版默认 1000 是为保持现有行为不变;如果你希望默认就分页,给我一个推荐值(例如 10 或 20),改一个常量即可,不用动逻辑。
    • 配置说明同步到 src/main/resources/配置详情.yml,docker 部署在 docker/wvp/wvp/application-docker.yml 给了注释示例(# record-info-page-size: ${RecordInfoPageSize:1000})。
  2. SIPCommanderForPlatform:recordInfo(...) 改为按页循环发送;抽出两个静态方法
    • partitionRecordItems(recordList, pageSize):按每页数量切分(pageSize <= 0 或记录数不超过一页时,仍是"一页",即原路径);
    • buildRecordInfoXml(characterSet, sn, gbDeviceId, sumNum, pageItems):生成一页的 XML,输出格式与改动前逐字一致,只有 RecordList Num 随本页条数变化。
  3. 分页触发条件:记录总数 > record-info-page-size 且 record-info-page-size > 0。默认值下等价于"超过 1000 条才分页"。
  4. 不包含:设备侧查询请求的分页(设备行为,本 PR 不动)、Redis 聚合逻辑、页间发送间隔(保持最小改动;若需要可按后续议题再加)。

改动文件:

文件 说明
src/main/java/com/genersoft/iot/vmp/conf/UserSetting.java 新增 recordInfoPageSize(默认 1000)
src/main/java/com/genersoft/iot/vmp/gb28181/transmit/cmd/impl/SIPCommanderForPlatform.java 分页发送 + partitionRecordItems / buildRecordInfoXml
src/main/resources/配置详情.yml 配置项说明
docker/wvp/wvp/application-docker.yml 注释示例
src/test/java/com/genersoft/iot/vmp/gb28181/transmit/cmd/impl/RecordInfoPagingTest.java 新增单测(切分逻辑 + 单页 XML 逐字比对)

验证方式

  1. 编译:JDK 21 下 mvn -DskipTests -q compile → exit 0。
  2. 单测:新增 RecordInfoPagingTest(4 个用例)——
    • pageSize <= 0 / null 时不分页(与历史行为一致);
    • 250 条 / 每页 100 → 3 页(100/100/50),所有记录不重不漏;
    • 空列表 → 仍回复一个 Num=0 的单页;
    • 分页时 SumNum 始终为总条数、RecordList Num 为本页条数;单页输出与改动前逐字一致(含 <Item> 内字段顺序)。
    • 说明:该仓库 pom.xml 默认 <skipTests>true</skipTests>,本地验证时临时放开后运行,命令为
      mvn -Dtest=RecordInfoPagingTest -DfailIfNoTests=false test(结果:Tests run: 4, Failures: 0, Errors: 0)。提交内容不含对 pom.xml 的任何修改。

未验证项

  • 未做端到端验证:本机没有上级平台与真实设备,未验证分页后上级能否按 SN 正确合并多页(国标要求按 SN 聚合并以 SumNum 判断结束,但各家实现存在差异)。
  • 未验证最合适的每页数量:默认 1000 只保证"不改变现状";UDP 环境建议按实际 MTU 显著调小(例如 10),这一点需要真实环境确认。若维护者希望默认就开启分页,我可以把默认值改成 MTU 友好的小值。
  • 未改设备侧查询分页与 Redis 聚合路径,超大结果的聚合内存行为与今天一致。

备注

  • 若认为不应引入新配置键名,或希望默认值直接生效(例如 10/50),告诉我即可调整;分页逻辑本身与默认值解耦。

可复现命令块

本仓库 pom.xml 里 surefire 插件的 <skipTests> 硬编码为 true,直接跑会输出 Tests are skipped.。本地复现需要先把它临时改成 false(该 pom 改动未提交,PR 里不含),然后:

mvn -Dtest=RecordInfoPagingTest test

预期输出(本机实测 2026-09-26):

[INFO] Running com.genersoft.iot.vmp.gb28181.transmit.cmd.impl.RecordInfoPagingTest
[INFO] Tests run: 4, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.370 s -- in com.genersoft.iot.vmp.gb28181.transmit.cmd.impl.RecordInfoPagingTest
[INFO] Tests run: 4, Failures: 0, Errors: 0, Skipped: 0
[INFO] BUILD SUCCESS

4 个用例覆盖:

  1. pageSize <= 0 与 null → 不分页(与历史行为一致);
  2. 250 条 / 每页 100 → 3 页 100 / 100 / 50,所有记录不重不漏;
  3. 空列表 → 仍回复一页 RecordList Num="0";
  4. 分页时 SumNum 始终为总条数、RecordList Num 为本页条数;并断言单页输出与改动前逐字一致(含 <Item> 内字段顺序)。

编译另有:mvn -DskipTests -q compile(JDK 21)→ exit 0。

@vercel

vercel Bot commented Sep 26, 2026

Copy link
Copy Markdown

@CieveMe is attempting to deploy a commit to the 648540858's projects Team on Vercel.

A member of the Team first needs to authorize it.

@648540858
648540858 merged commit bf63094 into 648540858:master Oct 20, 2026
1 check failed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants