百度秒哒预览空白需三路排查：先确认预览走本地（localhost）还是云端（smartapp.baidu.com），本地需检查端口占用及dev-server日志；再验证组件数据源类型、模拟数据json结构与路径解析设置，以及调试模式登录态；最后测试api接口可达性、cors配置及x-bd-smartapp-preview请求头兼容性，并清除cache重启服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
百度秒哒预览时页面空白、组件不渲染或数据不显示，说明预览环境未能正确加载运行时资源或数据通道中断，需从本地开发态、服务端配置、数据源连通性三路并行排查。
确认预览是否走本地开发服务
第一步：在秒哒编辑器右上角点击「预览」按钮后，观察浏览器地址栏——若URL以http://localhost:8080或http://127.0.0.1:8080开头，说明走的是本地开发服务；若跳转至https://smartapp.baidu.com/preview/xxx等线上域名，则为云端预览模式。【必须区分二者，本地预览失败不能靠清线上缓存解决】
第二步：若为本地预览，打开终端查看秒哒IDE后台日志——有无webpack-dev-server started字样；若出现EADDRINUSE报错，说明8080端口被占用，需手动杀掉占用进程或修改IDE设置中的端口号。
检查组件数据绑定与模拟数据配置
方法一：点击画布中异常组件→右侧属性面板切换到「数据」标签页→确认「数据源类型」是否设为「模拟数据」。若误选「API接口」但未填写有效URL，组件将静默失败，不报错也不渲染。
方法二：展开「模拟数据」编辑区→检查JSON结构是否符合组件要求。例如「商品列表」组件要求顶层为数组，若填入{"list": [...]}却未勾选「启用路径解析」并填写list，数据将无法注入——这一步常被忽略，导致预览时显示“暂无数据”。
方法三：对含条件显示逻辑的组件（如登录后才展示的优惠券模块），在预览前点击右上角「调试模式」开关→手动切换用户登录态为「已登录」，否则条件判断直接跳过渲染分支。
验证API接口在预览环境是否可达
① 在组件属性中找到「API接口」字段，复制完整URL（含协议、域名、路径）；
② 将该URL粘贴至浏览器新标签页访问——若返回404或CORS error，说明接口未部署或跨域未配置；
③ 若返回正常JSON，但秒哒预览仍无数据，按F12打开开发者工具→切换Network→筛选XHR→触发组件加载动作→观察对应请求是否发出、响应内容是否为空或格式错误；【注意：预览时API请求默认携带X-BD-SMARTAPP-PREVIEW: true请求头，部分后端会据此拒绝响应】
④ 临时在API服务端添加对该请求头的放行规则，或改用「模拟数据」过渡验证。
清除秒哒本地缓存与重启开发服务
关闭所有秒哒IDE窗口→打开文件管理器，定位到%LOCALAPPDATA%\Baidu\SmartAppStudio\Cache（Windows）或~/Library/Caches/com.baidu.smartappstudio（macOS）→删除整个Cache文件夹；
重新启动秒哒IDE→等待底部状态栏显示「Dev Server Ready」后再点击预览；
这一步操作起来很简单，直接删掉Cache就能重置所有本地编译产物和模拟数据快照，避免旧版本JS bundle干扰新逻辑。
