产品API有数据，页面却是空壳：上线前把HTML交付条件写清楚

接口返回了产品数据，只能说明数据服务有响应，不能说明搜索引擎取得了可索引的产品正文。API驱动的详情页上线前，应分别核对首份HTML、无需用户操作的渲染结果和接口失败时的页面状态。对希望稳定获取自然搜索访问的重点产品，建议把名称、主要用途、关键规格和真实内链直接交付在HTML中，再用JavaScript补充交互和实时信息。

接口、初始HTML和渲染页面是不同对象

假设某型号的接口包含名称、扭矩范围和安装尺寸，但访问详情页时，服务器只返回一个空的div与脚本地址。普通用户可能等脚本执行完就看到内容；脚本加载失败、接口要求登录或返回错误时，页面仍然可能只剩加载动画。API测试中的绿色结果没有覆盖这些环节。

Google的JavaScript SEO文档说明，应用外壳模式可能需要执行脚本才能获得实际内容，Google也会使用渲染后的HTML进行索引。因此，“初始HTML为空就一定不能收录”说得过头；但把全部主要内容放到更多执行依赖后面，会增加排查和交付的不确定性。

项目验收应保存同一URL的原始响应和渲染后内容，不能把接口JSON当作正文截图，也不能把浏览器元素面板的结果误称为服务器已经输出的内容。二者都需要，但证明的事情不同。

先约定必须交付哪些正文

不要把“支持SSR”当成完整要求。服务端渲染只是实现方式，开发团队仍可能仅在服务端渲染导航，而把产品说明留给客户端。应以可检查的字段约定结果：当前型号名称、产品用途、选型所需参数、适用条件、产品图片及相关资料入口，都应与当前URL对应。

• 型号或产品ID必须确定，不能先返回通用介绍，再等客户端替换成具体产品。
• 关键规格要包含单位和必要条件，避免只输出参数名称，数值仍由点击事件加载。
• 图片和资料链接要指向实际资源；API内部地址、后台编辑地址不能直接露出到前台。
• 正文与页面标题、canonical、结构化数据要来自一致的产品记录，不能各用一个缓存版本。

服务端输出与浏览器首次接管要使用相容的数据版本。若初始HTML展示产品A，客户端因错误状态恢复展示产品B，即使两个阶段都“有文字”，也不能通过。相同问题在头部标签上的表现，可接着看hydration前后canonical变化的排查。

光算谷歌SEO服务包含网站技术建议与代码优化相关工作；若产品页依赖API，可按项目确定需要检查的模板、字段和开发协作范围。交付时应让负责人能回答：新访客拿到了哪份内容，接口出错会看到什么，而不只是“接口今天能通”。

把失败页面也写进发布条件

至少区分产品确实不存在、接口暂时不可用和访客没有访问权限。不存在的产品不是一个永久显示“加载中”的200页面；私有资料也不应为了抓取而绕开权限。暂时接口失败时，则应依据网站架构考虑保留可信的最近成功内容，或返回能反映临时故障的响应，不能直接把未知状态写成“已售罄”。

Google的JavaScript SEO文档建议使用有意义的HTTP状态码，也指出单页应用返回200错误页可能产生软404问题。状态码应由能控制响应的服务端正确设置。若现有架构暂时做不到，需要按官方的单页应用错误处理方法评估替代方案，而不是在通用页面一律加入noindex，指望之后再靠脚本移除。

错误降级还要保护采购信息。旧尺寸资料可能仍可用，旧库存承诺却可能误导客户。保留最后成功版本时，应定义哪些字段可以沿用、哪些字段需要显示无法确认及核验入口。这是业务选择，需要产品负责人确认，不是框架能自动决定的规则。

接口返回200，还要检查实际字段

HTTP请求成功不代表商品对象完整。接口可能返回空数组、业务错误对象，或只返回名称而缺少规格。验收应把“网络成功”和“业务数据可用”分开，检查产品ID、必要字段及当前语言；不能用对象存在或响应体非空作为唯一条件。如果请求失败后沿用旧状态，浏览器可能继续显示上一个型号，看上去反而比空页更像正常结果。

还需防止并发请求乱序。访客快速从产品A切到B时，A的响应可能更晚返回；页面应确认响应属于当前路由后再显示，必要时取消过期请求。这类缺陷在直接打开B时不会出现，必须通过连续切页复现。工单中记录切换顺序，比只附最终错误截图更容易定位。

用一张工单收齐可复现材料

1. 选一个正常型号和一个明确不存在的教学测试型号，记录直接访问的完整URL与响应状态。
2. 在无登录、无已有缓存的浏览器环境检查首屏与主要参数，不先点击按钮“帮页面加载”。
3. 在受控测试环境模拟接口失败，确认不会输出错误型号、无限骨架屏或未经确认的库存。
4. 比较HTML正文和API记录中的关键字段，并查看脚本或网络错误。不要只检验页面非空。
5. 上线后由有权限的人用Google工具检查公开URL的渲染内容，再观察实际索引状态。

这些步骤中的本地测试只能证明被测实现的行为，不是所有爬虫的统一表现。SSR、预渲染、静态生成都可以作为实现选项，选择取决于内容变化频率、基础设施和维护能力，无须为了写进合同就指定某个框架。