Go / 系统课时
验证协议的异常输入
验证协议的异常输入
协议解码器真正危险的地方不是正常报文,而是被截断、伪造长度或携带未知类型的输入。本节用表驱动测试主动制造这些异常,验证解码器能否在分配内存和进入业务逻辑前及时拒绝问题数据,并返回可判断的错误。
学习目标
- 构造截断、超长和错误消息类型三类异常输入
- 为解码器建立明确的长度与类型防线
- 用表驱动测试确认错误可复现、不会触发越界或大内存分配
先把防御边界写进解码器
示例协议使用 5 字节头部:1 字节消息类型加 4 字节大端序负载长度。解码顺序很重要:先完整读取头部,再校验类型和长度,最后读取负载。这样超长报文不会先按攻击者声明的长度分配内存。
go
package protocol
import (
"bytes"
"encoding/binary"
"errors"
"fmt"
"io"
"testing"
)
const maxPayload = 1024
var (
errUnknownType = errors.New("unknown message type")
errTooLarge = errors.New("payload too large")
)
func decodeFrame(r io.Reader) (byte, []byte, error) {
var header [5]byte
if _, err := io.ReadFull(r, header[:]); err != nil {
return 0, nil, fmt.Errorf("read header: %w", err)
}
msgType := header[0]
if msgType != 1 && msgType != 2 {
return 0, nil, fmt.Errorf("%w: %d", errUnknownType, msgType)
}
n := binary.BigEndian.Uint32(header[1:])
if n > maxPayload {
return 0, nil, fmt.Errorf("%w: %d", errTooLarge, n)
}
payload := make([]byte, int(n))
if _, err := io.ReadFull(r, payload); err != nil {
return 0, nil, fmt.Errorf("read payload: %w", err)
}
return msgType, payload, nil
}
func frame(msgType byte, declaredLen uint32, payload []byte) []byte {
buf := bytes.NewBuffer(nil)
buf.WriteByte(msgType)
_ = binary.Write(buf, binary.BigEndian, declaredLen)
buf.Write(payload)
return buf.Bytes()
}
func TestDecodeFrameRejectsBadInput(t *testing.T) {
tests := []struct {
name string
data []byte
want error
}{
{"truncated header", []byte{1, 0, 0}, io.ErrUnexpectedEOF},
{"oversized payload", frame(1, maxPayload+1, nil), errTooLarge},
{"unknown type", frame(9, 0, nil), errUnknownType},
{"truncated payload", frame(1, 4, []byte{1, 2}), io.ErrUnexpectedEOF},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
_, _, err := decodeFrame(bytes.NewReader(tt.data))
if !errors.Is(err, tt.want) {
t.Fatalf("want %v, got %v", tt.want, err)
}
})
}
}把代码保存为 decoder_test.go 后执行:
bash
go mod init example/protocol
go test -v预期输出
text
=== RUN TestDecodeFrameRejectsBadInput
=== RUN TestDecodeFrameRejectsBadInput/truncated_header
=== RUN TestDecodeFrameRejectsBadInput/oversized_payload
=== RUN TestDecodeFrameRejectsBadInput/unknown_type
=== RUN TestDecodeFrameRejectsBadInput/truncated_payload
--- PASS: TestDecodeFrameRejectsBadInput (<TIME>)
--- PASS: TestDecodeFrameRejectsBadInput/truncated_header (<TIME>)
--- PASS: TestDecodeFrameRejectsBadInput/oversized_payload (<TIME>)
--- PASS: TestDecodeFrameRejectsBadInput/unknown_type (<TIME>)
--- PASS: TestDecodeFrameRejectsBadInput/truncated_payload (<TIME>)
PASS
ok example/protocol <TIME>其中 <TIME> 是每次测试运行产生的实际耗时,具体值会不同。
为什么要先校验长度和类型
异常输入测试不只是确认“返回了错误”,还要确认错误发生在正确阶段。未知类型应在进入业务处理前被拒绝;长度超过上限时应在 make 之前返回,避免攻击者用伪造长度诱导大内存分配;负载被截断则应由 io.ReadFull 明确报告读取不完整。
对于来自 TCP 的数据,不能假设一次 Read 就拿到完整头部或完整负载。io.ReadFull 会持续读取直到缓冲区填满或遇到错误,因此特别适合固定头部和已知长度负载。
扩展异常集合时盯住不变量
后续增加协议字段时,测试应继续围绕“不变量”扩展,而不是只堆随机字节。常见不变量包括:长度不得超过上限、枚举值必须在已知集合内、校验字段必须匹配、必填字段不能缺失。
当这些异常输入都能稳定得到预期错误时,解码器才算具备最基本的防御能力;再把同一组用例接入模糊测试,可以继续覆盖人工没有想到的字节组合。
按自己的节奏,确认真正理解。