故障排查GitHub issue3 分钟阅读故障排查

解决FastGPT中Next.js大页面数据阈值警告问题

部署FastGPT 4.8.16版本后,控制台出现如下警告信息: 涉及/dataset/detail和/两个页面,数据量分别为175 kB和150 kB,均超出128 kB阈值,官方提示该情况可能降低页面性能。

现象

部署FastGPT 4.8.16版本后,控制台出现如下警告信息:

Warning: **data for page "/dataset/detail"** (path "/dataset/detail?datasetId=6770058fa7ceasd52f12&collectionId=67700217ceae0b7122f35&currentTab=dataCard") is 175 kB which exceeds the threshold of 128 kB, this amount of data can reduce performance.
See more info here: https://nextjs.org/docs/messages/large-page-data

Warning: **data for page "/" is 150 kB** which exceeds the threshold of 128 kB, this amount of data can reduce performance.
See more info here: https://nextjs.org/docs/messages/large-page-data

涉及/dataset/detail/两个页面,数据量分别为175 kB和150 kB,均超出128 kB阈值,官方提示该情况可能降低页面性能。

可能原因

该警告由Next.js的页面数据传输阈值限制触发,FastGPT的对应页面返回的数据量超出了Next.js默认的128 kB阈值。具体影响因素需按实际环境确认。

排查步骤

  1. 确认当前FastGPT版本为4.8.16,记录触发警告的页面路径与对应数据大小。
  2. 访问对应页面,查看接口返回的初始化数据与业务数据集的实际大小,验证是否超过128 kB阈值。
  3. 查阅Next.js官方文档中large-page-data相关说明,确认阈值规则与优化方向。

解决与验证

可参考Next.js官方文档的优化方案,对页面数据进行分页加载、拆分传输,减少单次返回的数据量。验证时,调整数据加载逻辑后重新部署,访问对应页面,确认控制台不再出现该警告,同时观察页面性能变化。

来源: FastGPT 官方来源

适用性与版本范围

本页适用于官方来源记录的 故障排查 场景。执行变更前,需核对 FastGPT、依赖、API 与部署版本。

安全护栏

凭证与私密数据使用 [REDACTED_CREDENTIAL] 占位符。执行操作前需核对文档的环境与版本。

回滚指引

恢复变更前的技术内容权威快照、已保存配置与数据快照,再执行最小验证场景。