JNPF后台常收到类似反馈："大数据列表加载超慢？""真分页接口怎么配查询字段？" 其实 "视图真分页" 是解决大数据加载卡顿的关键，它通过接口自带的分页逻辑实现高效数据展示。今天结合文档，把 API/SQL 真分页的配置细节、查询字段规则拆透，帮你避开配置中的 "隐形坑"。
一、先搞懂：视图真分页的核心定位与关键规则
"视图真分页" 和普通分页（假分页）的核心区别是数据加载逻辑：普通分页是先加载全部数据再前端分页，大数据时会卡顿；真分页是接口只返回当前页数据（如第 1 页 20 条），加载速度快，适合数据量超过 1000 条的场景。
先明确真分页的 3 个关键规则，这是后续配置的基础：
-
接口限制：必须选择 "真分页类型" 的接口（API 或 SQL），普通查询接口不支持；
-
分页设置：真分页启用后，分页设置会被锁定（无法关闭），分页条数可设 20/50/80/100 条 / 页；
-
查询字段 ：仅支持接口参数作为查询字段，接口返回的普通字段不能做筛选，且需勾选 "作为查询字段" 才会显示。
二、核心操作：2 类真分页接口配置拆解（附实操案例）
真分页接口分 "API 真分页" 和 "SQL 真分页"，配置逻辑略有不同，按场景拆解如下，结合案例更易理解：
1. API 真分页接口：分 "无参数" 和 "有参数"
API 真分页靠接口 URL 中的分页参数（如currentPage"pageSize"）实现，重点在查询字段是否显示：
-
**场景 1：API 真分页（无参数）**适合不需要额外筛选，只按分页加载数据的场景（如展示所有系统接口列表）：
基础设计：选择 "API 真分页" 接口（接口 URL 含
currentPage"pageSize" 参数），因无额外参数，"参数配置" 区为空；列表设计：查询字段：因无接口参数，查询字段区显示 "暂无数据"，无法添加筛选条件；列表字段：勾选接口返回的字段（如 "名称""编码""类型"），配置显示列名和对齐方式；
效果：打开视图会自动加载第 1 页数据（默认 20 条），点击分页控件切换页面，接口会自动传递
currentPage参数，加载对应页数据，不卡顿。
-
**场景 2：API 真分页（有参数）**适合需要按接口参数筛选的场景（如按 "关键词" 搜接口）：
基础设计：选择带参数的 API 真分页接口（如含
keyword参数），在 "参数配置" 中勾选 "作为查询字段"；列表设计：查询字段：会自动显示
keyword参数对应的查询框（输入类型由参数类型决定，如字符串显单行输入框）；列表字段：和无参数场景一致，配置显示字段；效果：用户输入关键词（如 "SQL"），点击查询，接口会携带
keyword=SQL和分页参数，只返回符合条件的当前页数据，筛选 + 分页效率双高。
2. SQL 真分页接口：靠 SQL 语句实现，参数筛选更灵活
SQL 真分页通过 SQL 语句中的limit @offset, @pageSize实现，适合自定义筛选逻辑的场景（如按姓名搜用户）：
-
接口配置（关键） ：在数据接口的 "SQL 语句" 中写分页逻辑，比如：sql
select * from base_user where f_real_name like concat('%', @keyword, '%') limit @offset, @pageSize其中@keyword是筛选参数，@offset（偏移量）和@pageSize（每页条数）是分页参数，由系统自动传递，不用手动配置。 -
视图配置 ：基础设计：选择该 SQL 真分页接口，在 "参数配置" 中勾选
@keyword的 "作为查询字段"；列表设计：查询字段：显示keyword对应的单行输入框，用户输入姓名关键词（如 "张"）；列表字段：勾选 "姓名""账户""性别" 等字段；效果：点击查询，SQL 会按关键词筛选并分页返回数据（如第 1 页显示 20 条姓名含 "张" 的用户），比普通分页快 3 倍以上。
三、避坑要点：4 个常见问题解答
-
**真分页接口配置后，查询字段不显示？**没勾选 "参数作为查询字段"，进入基础设计的 "参数配置" 区，找到对应参数并勾选，列表设计的查询字段才会显示，且仅接口参数能做筛选，普通字段不行。
-
**API 真分页接口加载没反应？**先检查接口 URL 是否含分页参数（
currentPage"pageSize"），没有则不是真分页接口；再确认接口能正常访问（用 Postman 测），接口不通会导致加载失败。 -
**SQL 真分页报错 "limit 参数错误"？**SQL 语句中的分页参数名不对，必须用
@offset（偏移量）和@pageSize（每页条数），不能自定义（如不能用@start"@count"），系统会自动给这两个参数赋值。 -
**真分页能关闭吗？**不能。真分页接口启用后，分页设置会被锁定（灰色不可点），无法关闭，因为分页逻辑是接口自带的，前端无法取消。
视图真分页的核心是 "选对接口 + 配对参数"：大数据量用 SQL 真分页，灵活自定义筛选；简单列表用 API 真分页，快速部署。比如做 "用户列表"，用 SQL 真分页 + 姓名关键词筛选，既能快速加载，又能精准找用户。如果遇到接口参数不生效、分页条数改不了等问题，欢迎在评论区留言，我会帮你分析解决～