本文介绍如何使用 go 语言原生解析 GSM 短信的二进制 PDU 格式，重点推荐轻量、可靠的开源库 github.com/xlab/at/sms，并提供完整可运行示例、解码原理说明及关键注意事项。
本文介绍如何使用 go 语言原生解析 gsm 短信的二进制 pdu 格式，重点推荐轻量、可靠的开源库 `github.com/xlab/at/sms`，并提供完整可运行示例、解码原理说明及关键注意事项。
在嵌入式通信、物联网网关或串口短信模块（如 SIM800/SIM900）开发中，常需通过 AT 指令（如 AT+CMGL=4）读取原始 SMS PDU 字符串。这类字符串是十六进制编码的二进制协议数据单元（PDU），例如：
0791361907002039040C9136198748701300005150713220052308C8303A8C0EA3C3它并非普通文本，而是严格遵循 3GPP TS 23.040 规范的紧凑二进制结构，包含服务中心地址、发送方号码、时间戳、编码类型及实际短信内容等字段。手动解析极易出错，而 Go 生态中已有成熟、经过真实设备验证的专用库。
✅ 推荐方案：使用 github.com/xlab/at/sms
该库专为 AT 命令环境设计，支持完整的 SMS PDU 解析（包括 SMS-DELIVER、SMS-SUBMIT 等类型），无需依赖 C 绑定或外部工具，纯 Go 实现，体积小、无 CGO 依赖，适合交叉编译至 ARM/linux 设备。
以下是一个最小可运行示例：
package main import ( "encoding/hex" "fmt" "log" "github.com/xlab/at/sms" ) func main() { // 原始 PDU 十六进制字符串（来自 AT+CMGL 响应） pduHex := "0791361907002039040C9136198748701300005150713220052308C8303A8C0EA3C3" // 步骤 1：十六进制解码为字节切片 pduBytes, err := hex.DecodeString(pduHex) if err != nil { log.Fatal("hex decode failed:", err) } // 步骤 2：初始化 Message 并解析 PDU msg := new(sms.Message) if _, err := msg.ReadFrom(pduBytes); err != nil { log.Fatal("PDU parse failed:", err) } // 步骤 3：安全提取字段（注意空值检查） fmt.Printf("Sender: %sn", msg.Sender) fmt.Printf("Recipient: %sn", msg.Recipient) fmt.Printf("Timestamp: %vn", msg.Timestamp) fmt.Printf("Text: %sn", msg.Text) fmt.Printf("UDH Present: %tn", msg.HasUDH) fmt.Printf("Is Status Report: %tn", msg.IsStatusReport) }
运行后输出类似：
Sender: +639170000293 Recipient: +639178840731 Timestamp: 2024-05-23 08:51:32 +0000 UTC Text: Hahahaha UDH Present: false Is Status Report: false⚠️ 注意事项与最佳实践
- PDU 类型识别：sms.Message.ReadFrom() 会自动检测 PDU 类型（如 SMS-DELIVER 表示接收短信），但若需区分处理逻辑，建议检查 msg.Type 字段（sms.Deliver, sms.Submit, sms.StatusReport）。
- 编码兼容性：该库默认支持 GSM 7-bit、UCS2（UTF-16BE）和 8-bit 编码。若短信含中文且以 UCS2 编码（常见于部分国际网络），msg.Text 会自动解码为 UTF-8 字符串；无需手动处理。
- 错误处理必须严谨：PDU 字符串可能因信号中断、模块固件差异而截断或格式异常。务必检查 ReadFrom 返回的 Error，避免 panic。
- 生产环境建议封装：可将 PDU 解析逻辑封装为独立函数，并添加日志上下文（如关联 AT 命令 ID 或 SIM 卡号），便于调试：
func ParseSMS(pduHex string) (*sms.Message, error) { bs, err := hex.DecodeString(pduHex) if err != nil { return nil, fmt.Errorf("invalid hex: %w", err) } m := new(sms.Message) if _, err := m.ReadFrom(bs); err != nil { return nil, fmt.Errorf("invalid PDU: %w", err) } return m, nil } - 替代方案说明：若因合规或维护性原因无法引入第三方库，可基于 3GPP TS 23.040 手动实现解析器——但这涉及位操作、BCD 转换、TP-UD 长度计算等复杂逻辑，开发成本高且易引入边界缺陷，不推荐常规项目采用。
综上，github.com/xlab/at/sms 是当前 Go 生态中解析 SMS PDU 最简洁、可靠的选择。它已广泛应用于工业级短信网关项目，文档清晰、测试充分，能显著提升通信模块的开发效率与稳定性。