站内搜索功能怎样写验收用例
站内搜索看似简单,验收时却常因“搜得到”与“搜得准”的标准不同而扯皮。若合同附件只写“实现站内搜索功能”,开发方可能只验证关键词能返回结果,而甲方期望的是标题、正文、标签都能命中,且停用内容不出现。本文围绕搜索字段、空查询、无结果、权限过滤和停用内容五个分支,给出可写进验收附件的用例格式与测试样本,帮助双方在签约前把预期落成可逐条勾选的记录。
先约定搜索字段与匹配范围
验收用例的第一行应写明搜索覆盖哪些字段。常见可选范围包括标题、正文、摘要、标签、作者和发布时间,但不必全部纳入。双方需逐项勾选,并注明是否支持模糊匹配、是否区分大小写、是否对同义词或简繁体做转换。例如约定“标题和正文参与搜索,标签不参与”,则测试时用仅出现在标签中的词搜索,预期结果应为无结果。
字段权重若影响排序,也应在附件中说明。例如“标题命中优先于正文命中”,并给出一个可复现的样本:准备两条内容,一条标题含关键词,另一条正文含同一关键词,搜索后预期标题命中的条目排在前面。若双方不约定排序规则,验收时只核对“是否出现”,不核对“谁先谁后”,避免把排序偏好当成缺陷。
空查询与无结果分支的用例写法
空查询指搜索框未输入任何字符或只输入空格时提交。验收用例应写明预期行为:是停留在当前页并给出提示,还是返回全部内容,或是禁用搜索按钮。三种做法都可接受,但必须提前选定一种并写入附件。测试样本可设计为:清空输入框后点击搜索,记录页面实际反应,与约定行为逐字核对。
无结果分支指关键词在约定字段中均未命中。用例应写明页面展示什么:无结果提示语、推荐内容、还是保留搜索框并允许修改关键词。同时约定是否记录搜索词及保留期限,并说明该约定需符合适用的个人信息与日志留存要求。测试时用一个明显不存在的字符串(如由随机字母组成的词)提交,核对提示语是否出现、页面是否报错、是否暴露数据库错误信息。预期结果应写成“显示约定提示语,不出现程序错误页”,而非“用户体验良好”这类无法核对的说法。
权限过滤与停用内容的测试样本
若站点存在登录后可见的内容,搜索必须按当前用户权限过滤。验收用例应准备至少两个账号:一个可查看全部内容,一个仅可查看公开内容。用同一关键词分别登录搜索,预期公开账号的结果中不出现受限条目,全部权限账号的结果中包含该条目。测试记录需写明账号角色、搜索词、结果条数及条目名称,便于复核。
停用内容指已下架、草稿或标记为不公开的条目。用例应约定:停用内容是否参与搜索。若约定不参与,则准备一条已停用但标题含关键词的内容,搜索后预期结果中不出现该条目。若约定参与但需标注状态,则预期结果中应出现该条目并带有可见的状态标识。两种约定都需在附件中写明,不能留到验收时口头解释。
测试记录表与核对方法
建议在附件中附一张测试记录表,字段包括:用例编号、搜索词、登录账号角色、约定字段范围、预期结果、实际结果、是否通过、测试人和日期。每个分支至少一条用例,空查询和无结果各一条,权限过滤两条(公开账号与全部权限账号),停用内容一条。测试样本中的内容条目应在测试环境中预先准备,并记录其标题和状态,避免测试后内容被修改导致无法复现。
核对时由双方共同操作,逐条填写记录表并签字或通过项目确认渠道留痕。若实际结果与预期不符,应记录差异描述和截图编号,不直接修改用例。验收结论以记录表的通过项为准,未通过项列入遗留清单并约定复测时间。搜索功能不涉及对外部搜索引擎排名的承诺,验收范围仅限于站内约定字段的查询与过滤行为。
