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 会持续读取直到缓冲区填满或遇到错误,因此特别适合固定头部和已知长度负载。

扩展异常集合时盯住不变量

后续增加协议字段时,测试应继续围绕“不变量”扩展,而不是只堆随机字节。常见不变量包括:长度不得超过上限、枚举值必须在已知集合内、校验字段必须匹配、必填字段不能缺失。

当这些异常输入都能稳定得到预期错误时,解码器才算具备最基本的防御能力;再把同一组用例接入模糊测试,可以继续覆盖人工没有想到的字节组合。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

验证协议的异常输入

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通