Flutterflow测试模式显示白屏，预览模式正常求助

1. 核对构建配置与预览的一致性 #

• 确认测试模式的目标平台（Web/Android/iOS）和预览时完全一致，不同平台的构建规则可能存在差异
• 检查测试模式下的资源打包状态：如果用了本地图片/字体，确认它们已被正确添加到测试构建的资源列表中

2. 排查页面跳转与路由配置 #

• 逐个检查所有跳转按钮的目标页面设置，确保没有选择不存在的页面，或者页面名称存在大小写/拼写错误（FlutterFlow的页面路由对名称敏感）
• 尝试在测试模式下直接指定打开某个非首页的页面，验证是否是首页的渲染问题导致白屏

3. 清理缓存与重新构建 #

• 在FlutterFlow项目设置中找到「清理缓存」选项，执行后重新生成代码并构建测试版本
• 如果是Web测试模式，用浏览器无痕窗口打开，或者清空浏览器缓存后重试，排除缓存残留的干扰

4. 查看构建日志与导出代码调试 #

• 查看测试模式构建的详细日志，FlutterFlow在构建过程中会输出更底层的错误信息，可能找到浏览器控制台未显示的异常（比如路由初始化失败、组件渲染约束错误）
• 导出项目代码到本地，用Flutter CLI运行flutter run测试，本地环境会输出更详细的报错堆栈，帮助定位问题

5. 检查组件与布局的兼容性 #

• 排查添加的组件是否存在测试模式不支持的设置：比如某些布局组件的约束参数（如无限宽高）在预览时能兼容，但测试构建时触发渲染异常
• 暂时移除所有跳转按钮，只保留基础组件，测试是否能正常显示，逐步排查是组件还是路由的问题

6. 确认基础配置正确性 #

• 检查项目的入口页面设置，确保测试模式默认打开的是已配置好的有效页面
• 排查是否存在全局初始化逻辑或加载遮罩组件，不小心将页面内容完全遮挡

内容的提问来源于stack exchange，提问作者Ganesh Rajan