打开阿里云帮助文档，第一眼往往是目录很长，不知道该点哪个。其实文档结构比较固定，摸清几个入口，多数问题十分钟内就能找到方向。下面说说各类文档分别管什么，再用一个 ECS 网站访问不了的例子走一遍排查，最后讲文档没写清楚时怎么办。
各类文档分别管什么
每个产品下的文档大致分为几类，名称不完全一样，但内容基本对应：
- 产品概述：讲功能、适用场景和计费方式。选型时先看这里，能省掉不少来回比较的时间。
- 快速入门：从开通到上手的步骤，第一次用某个产品时照着做就行。
- 控制台操作：图文结合，说明配置项在哪里、每个选项是什么意思。
- API 参考：接口列表、请求参数和返回示例，写程序调用时对着查。
- 最佳实践：按典型业务给出的推荐做法，设计架构时可以参考，不一定照搬。
- 常见问题和故障排查：高频问题和对应的处理步骤，报错了优先看这两个。
选型看概述，动手看入门和控制台，写代码看 API，出问题看排查。记住这个顺序，基本够用。
先定位问题，再搜索
文档总量大，一页页翻效率很低。比较快的做法是先把问题想清楚，再去搜：
- 先判断问题属于哪个产品。网站打不开，多半和云服务器 ECS、安全组或负载均衡有关，可以从这几个入口找起。
- 再判断问题是哪一类。是“怎么做”，就看控制台操作；是“为什么报错”，就看故障排查；是“某个参数怎么传”，就看 API 参考。
- 在帮助中心搜索框里输入具体的报错信息或功能名，例如“安全组 端口 不通”。这样比输入“服务器打不开”更容易搜到对口的页面。
- 进入页面后，先核对产品版本和地域。同一功能在不同地域的入口或限制可能不一样，地域选错，照着做也对不上。
案例：ECS 上的网站外网打不开
一位开发者在阿里云买了台 ECS，部署好网站，启动了 Web 服务。服务器本机用 curl 访问 80 端口没问题，但在外网浏览器里输入公网 IP，页面一直转圈直到超时。
排查过程
- 先确认服务本身正常：在服务器上做本机访问，并检查 80 端口是否处于监听状态。这一步能排除程序本身的问题，剩下的可能性就集中在网络这一层。
- 搜故障排查文档：在帮助中心搜“ECS 公网无法访问”，进入 ECS 网络连接类的排查文档。
- 查安全组入方向规则：按文档指引打开实例所在的安全组，看入方向规则。这台实例只放行了 22 端口，80 端口没有对应的规则。
- 添加规则并验证：照着安全组的控制台操作文档，添加一条 TCP 80 端口、来源 0.0.0.0/0 的入方向规则。再从外网访问，页面正常打开。
整个过程不到十五分钟。文档把“服务正常”和“网络放行”拆成两件事来讲，所以开发者很快就能落到安全组这一层，不用在程序代码里反复折腾。
安全组文档里的提醒
这一步有个地方容易漏掉。文档提醒，放行的端口和来源范围要按业务需要设置。来源写 0.0.0.0/0，就等于这个端口对全网开放。如果只是内部服务，最好限定来源 IP 段。这类内容一般放在页面的“注意事项”或警告框里，读的时候别直接划过去。
读文档时留意的几处
- 先看前提条件：开头通常写了要先开通哪些服务、需要什么权限。跳过这一段，后面的步骤经常走不通。
- 注意计费和影响范围：释放、重启、变配这类操作，文档一般会写清楚是否收费、会不会中断业务。动手前看一眼，能避免误操作。
- 调接口前先看参数：在 API 参考里确认必填项和取值范围，再用示例请求验证。比凭感觉试参数快得多。
- 对照文档更新时间：云产品功能更新比较频繁。如果页面描述和控制台对不上，先看文档日期，再决定以哪边为准。
文档没解决问题怎么办
按文档操作后问题还在，可以按下面的顺序往下走：
- 把完整的错误信息、请求 ID、实例 ID 和出问题的时间记下来。技术支持定位原因时，这些信息最有用。
- 回到对应产品的常见问题页，看有没有相似的案例。
- 去阿里云社区搜关键词，看看其他用户是怎么处理的。
- 如果问题已经影响业务，在控制台提交工单，把前面记录的信息附上。
帮助文档是排查的起点。问题拆清楚、搜索准确，再按前提条件和注意事项一项项核对，大部分情况下就能找到方向。
