技术文档从首页能打开，分享链接却失败：深层路由怎么验
开发者从文档首页点进配置说明，一切正常；把地址发给同事，对方却看到404、首页或者空白。这通常需要先检查直接请求和内容依赖，而不是先换前端框架。站内点击可能复用了已经加载的路由、数据和登录状态，新的访问者并没有这些前提。
留一条能重复验证的路径
挑选一篇公开文档，记下完整地址、文档标题、一个独特的配置项和正文中的下一步链接。不要只记“页面能打开”。如果预期内容是某个版本的安装指南，返回旧版指南或通用欢迎页也算失败，即使状态码为200。
- 从首页点击进入，保存当前结果。
- 把同一地址放进没有登录状态的新窗口，直接访问并刷新。
- 查看开发者工具的Document请求，核对状态码、跳转目标和响应HTML。
- 查看正文接口与脚本请求，确认失败发生在服务器路由还是浏览器执行阶段。
原始HTML没有正文，说明页面可能需要客户端渲染，不足以直接判定Google不能处理。反过来，浏览器显示了正文，也不证明任意新会话、爬虫或分享入口都能取得同样内容。
根据症状决定交给谁处理
直接请求404，但站内点击正常：优先检查部署端是否认识该路由，静态生成时是否输出了对应文档，以及服务器的重写规则。不要把所有地址都无条件变成200首页；真实不存在的文档也需要明确的错误处理。
外壳正常，正文接口401：确认这是否本来就是私人文档。应公开的资料需要合适的公开获取路径；内部资料则保留权限控制，并为分享者说明访问条件。不能为了解决搜索问题开放整个后台接口。
只有旧浏览器窗口正常：检查本地存储、缓存数据和登录状态。再观察新部署的HTML是否引用了已经删除的旧脚本。先记录失败请求的确切文件名和返回内容，避免把每一种白屏都归到“SEO不好”。
路由修好以后，补验文档身份
每一篇公开文档应给读者稳定地址，目录链接应在最终HTML中形成带有效href的链接。正文里的标题、页面title和canonical要指向当前文档的正确身份，不应点击不同章节却一直保留首页的规范地址。
Google的JavaScript SEO基础说明将抓取、渲染与索引分开，并提醒不要在需要索引的初始HTML里先设置noindex，再依赖JavaScript去掉。这里的检查应同时覆盖初始响应、HTTP头和执行后的页面。
需要把问题整理给Vue或React开发人员时，可以使用光算的JavaScript网站渲染与路由排查指南作为中文检查资料，附上本次失败URL、预期文字和请求记录，而不是只发一张空白截图。
最后再测一个不存在的文档
正常地址修好后，故意访问一个不存在的路径，检查是否得到真正的错误响应或清晰、适当的错误处理。再验证一篇刚更新的文档与一篇旧版文档，确认版本内容没有串用。
发布验收可以记为“直接访问成功、正文正确、链接与索引指令一致”。Google是否已经重新抓取和索引，要在相应工具中另行观察；一次浏览器测试通过，不能替代后续搜索状态。