Go testing.T.Attr 为什么拒绝带空格的属性键

如果 testing.T.Attr 报告 disallowed whitespace in attribute key，通常不是 Go 把空格当成了语法错误，而是属性键有意被限制为不含任何 Unicode 空白的稳定标识。属性值也有单独的规则：不能包含回车或换行。处理办法是把用户可读的自由文本放在值中，把键先规范化为低基数、单行名称。

官方资料：https://pkg.go.dev/testing#T.Attr；实现源码：https://go.dev/src/testing/testing.go。

牢记两个边界：键不能有空白，值不能有回车或换行。T.Attr 没有返回 error，非法输入会让当前测试失败，并且不会记录这条属性。

• 键的检查使用 unicode.IsSpace，普通空格、制表符以及其他 Unicode 空白都算违规。
• 值只拦截 \r 和 \n，适合保存短小的单行上下文。
• 属性键应该表达稳定维度，例如 region、case_id，不要直接塞入一整段用户描述。
• 多行诊断、堆栈和原始响应更适合写入测试日志或测试输出。

先看 testing.T.Attr 的参数契约

T.Attr(key, value) 的两个字符串参数并不是同一种自由文本。属性键承担“这一条元数据属于哪个维度”的职责，因此实现会检查键中是否存在 Unicode 空白；只要存在，就调用测试对象的失败记录方法并返回。这里的空白不只包括 ASCII 空格，制表符、换行以及其他被 Unicode 识别为空白的字符也会命中。

属性值的限制更窄：实现检查的是回车和换行。也就是说，值可以包含普通标点和空格，但不要把多行日志原样传进去。把键和值分开理解后，报错里的 attribute key 就不会被误读为“属性功能不可用”。

为什么不是返回 error，而是让测试失败

这个 API 面向测试元数据记录，不是一个需要调用方逐项恢复的解析器。当前实现发现非法键时会报告 disallowed whitespace in attribute key，发现非法值时会报告 disallowed newline in attribute value，随后结束本次属性记录。调用点不需要再判断一个返回值，但测试结果已经被标记为失败。

func TestSearch(t *testing.T) {
	// 键是稳定维度，值是当前用例的单行上下文。
	t.Attr("case_id", "search-empty-keyword")

	// 这会让测试失败，不会把属性名当作带空格的自由文本保存。
	t.Attr("case id", "search-empty-keyword")
}

这也是为什么不能把 Attr 当作“先试写、失败后再修正”的普通存储接口。键名一旦来自配置、表格列名或用户输入，就应该在调用前完成规范化；如果输入本身是不可控的诊断文本，应改放到日志里。

把自由文本转换为稳定属性键

一个实用的划分是：用固定键名描述维度，用值描述该维度下的具体内容。例如键固定为 scenario，值可以是 search-empty-keyword；不要把“搜索 空关键词”直接当作键。这样既避免空白错误，也不会因为每个用户描述都不同而制造大量属性名。

package searchtest

import (
	"strings"
	"testing"
	"unicode"
)

// attrKey 把人类可读文本压成稳定的单行属性键。
func attrKey(label string) string {
	// Fields 按 Unicode 空白切分，再用下划线合并，避免 key 含空白。
	parts := strings.Fields(label)
	if len(parts) == 0 {
		return "unknown"
	}
	key := strings.ToLower(strings.Join(parts, "_"))
	// 额外检查保持调用方契约清晰，避免后续改动引入空白。
	if strings.ContainsFunc(key, unicode.IsSpace) {
		return "unknown"
	}
	return key
}

func recordScenario(t *testing.T, label, detail string) {
	// 键低基数、值单行；长日志仍应通过 t.Log 记录。
	t.Attr("scenario", attrKey(label))
	t.Attr("detail", strings.Join(strings.Fields(detail), " "))
}

示例中的 scenario 和 detail 是固定键，真正变化的是它们的值。strings.Fields 同时处理多种 Unicode 空白，并把连续空白折叠掉；对值使用同样的方式，是为了把可能跨行的自由文本压成单行，而不是为了“修复”原始日志。

值要保持单行，诊断信息另找出口

属性适合承载筛选、聚合或测试报告中可读的短字段，例如用例编号、后端类型、地区和数据集名称。它不适合替代完整日志。若值来自 HTTP 响应、SQL 语句或错误堆栈，应先决定是否只提取一个短摘要；需要保留换行和上下文时，用 t.Log 或测试框架的输出通道。

func TestImport(t *testing.T) {
	// 属性只保存可筛选的短标签，不承载整段错误堆栈。
	t.Attr("dataset", "customers-small")

	detail := "header mismatch\nrow: 18\ncolumn: email"
	// 日志可以保留多行诊断；不要把 detail 原样传给 Attr。
	t.Log(detail)

	// 属性值先变成单行摘要，避免回车和换行触发失败。
	t.Attr("failure_kind", strings.Join(strings.Fields("header mismatch\nrow: 18"), " "))
}

这里的关键不是把所有字符串都强行塞入属性，而是让属性保持低成本、可比较的元数据，把高容量内容留给日志。这样测试报告更容易筛选，失败时也不会因为二次记录属性而掩盖原始问题。

常见问题

普通空格为什么会让 T.Attr 失败？

因为键是属性维度名，当前实现用 unicode.IsSpace 拦截所有 Unicode 空白。把空格替换为下划线或改用固定键即可。

值里有制表符也会失败吗？

键和值的规则不同。键会按 Unicode 空白检查；值当前直接拒绝回车和换行。为了保持跨格式稳定，值也建议在进入 Attr 前折叠制表符和连续空白。

能不能把用户输入直接当作属性键？

不建议。用户输入既可能含空白，也可能造成属性维度数量失控。更稳妥的方式是使用固定键，把规范化后的输入放在值中，并限制长度和可接受字符。

需要记录多行错误时怎么办？

使用 t.Log 或测试输出保存多行内容；属性只保留错误类型、用例编号等短摘要。