本文详解如何让 go（使用 cfb 模式）与 python（pycryptodome）实现 aes 加密/解密互通，重点解决因默认分段大小不一致（go 用 128-bit，python 默认 8-bit）导致的解密乱码问题，并提供安全、可直接复用的跨语言加解密代码。
本文详解如何让 go（使用 cfb 模式）与 python（pycryptodome）实现 aes 加密/解密互通，重点解决因默认分段大小不一致（go 用 128-bit，python 默认 8-bit）导致的解密乱码问题，并提供安全、可直接复用的跨语言加解密代码。
在构建 Go 服务端 + Python 客户端的加密通信系统时，一个常见却极易踩坑的问题是：双方均使用 AES-CFB 模式，却无法正确解密对方生成的密文。典型现象包括：首字节正确、后续全乱码；或解密结果头部出现大量不可读填充字节（如 wØ™¹ÒÓ*2)±¶œo%）。根本原因并非密钥或 IV 错误，而是 CFB 模式的 segment size（分段大小）默认值不一致：
- ✅ Go 标准库 cipher.NewCFBEncrypter / NewCFBDecrypter 固定使用 128-bit（即 16 字节）分段，等同于 AES.MODE_CFB with segment_size=128；
- ❌ Python 的 PyCryptodome 中 AES.MODE_CFB 默认使用 8-bit（1 字节）分段，这是为向后兼容旧协议保留的行为，与 Go 不兼容。
因此，即使密钥、IV、明文完全相同，因加密链路中每一段的反馈依赖不同粒度的数据，最终密文和解密结果必然错位。
✅ 正确做法：统一指定 segment_size = 128
Python 端（需 PyCryptodome ≥ 3.4.7）
from Crypto.Cipher import AES
from Crypto.Random import get_random_bytes
import base64
def aes_cfb_encrypt(key: bytes, plaintext: bytes) -> str:
"""AES-128-CFB 加密（128-bit segment），URL-safe Base64 输出"""
iv = get_random_bytes(AES.block_size) # 16 bytes
cipher = AES.new(key, AES.MODE_CFB, iv=iv, segment_size=128)
ciphertext = cipher.encrypt(plaintext)
# 拼接 IV + 密文，Base64 URL-safe 编码（无填充）
return base64.urlsafe_b64encode(iv + ciphertext).rstrip(b'=').decode('ascii')
def aes_cfb_decrypt(key: bytes, encoded: str) -> bytes:
"""AES-128-CFB 解密（128-bit segment），支持 URL-safe Base64 输入"""
try:
# 补齐 Base64 填充并解码
padded = encoded + '=' * (4 - len(encoded) % 4)
data = base64.urlsafe_b64decode(padded.encode('ascii'))
except Exception as e:
raise ValueError("Invalid base64 input") from e
if len(data) < AES.block_size:
raise ValueError("Ciphertext too short")
iv, ciphertext = data[:AES.block_size], data[AES.block_size:]
cipher = AES.new(key, AES.MODE_CFB, iv=iv, segment_size=128)
return cipher.decrypt(ciphertext)Go 端（标准库，无需额外依赖）
package main
import (
"crypto/aes"
"crypto/cipher"
"crypto/rand"
"encoding/base64"
"io"
"errors"
)
// Encrypt returns URL-safe base64-encoded AES-128-CFB ciphertext (IV + encrypted)
func Encrypt(key, plaintext []byte) (string, error) {
block, err := aes.NewCipher(key)
if err != nil {
return "", err
}
if len(key) != 16 {
return "", errors.New("key must be 16 bytes for AES-128")
}
ciphertext := make([]byte, aes.BlockSize+len(plaintext))
iv := ciphertext[:aes.BlockSize]
if _, err := io.ReadFull(rand.Reader, iv); err != nil {
return "", err
}
stream := cipher.NewCFBEncrypter(block, iv)
stream.XORKeyStream(ciphertext[aes.BlockSize:], plaintext)
// URL-safe base64 encoding (no padding)
return base64.URLEncoding.EncodeToString(ciphertext), nil
}
// Decrypt decodes URL-safe base64 and decrypts AES-128-CFB
func Decrypt(key []byte, encoded string) ([]byte, error) {
data, err := base64.URLEncoding.DecodeString(encoded)
if err != nil {
return nil, err
}
if len(data) < aes.BlockSize {
return nil, errors.New("ciphertext too short")
}
block, err := aes.NewCipher(key)
if err != nil {
return nil, err
}
iv, ciphertext := data[:aes.BlockSize], data[aes.BlockSize:]
stream := cipher.NewCFBDecrypter(block, iv)
stream.XORKeyStream(ciphertext, ciphertext)
return ciphertext, nil
}? 关键注意事项
- 密钥长度必须严格匹配：AES-128 要求密钥为 16 字节（128 bits）。若使用 "asdfasdfasdfasdf" 字符串，请确保其 UTF-8 编码长度为 16（推荐直接使用 []byte{...} 或 hex.DecodeString("...") 初始化）。
- IV 必须随机且每次加密唯一：两段代码均已通过 rand.Reader / get_random_bytes 安全生成 IV，切勿复用 IV。
- 不要手动填充明文：CFB 是流模式，无需 PKCS#7 填充。上述代码对任意长度明文均有效。
- 传输格式统一：始终采用 IV || ciphertext 拼接 + URL-safe Base64（base64.URLEncoding / urlsafe_b64encode），避免 + 和 / 在 HTTP 中被转义。
-
安全增强建议：
- 添加消息认证（HMAC-SHA256 或 AES-GCM）防止篡改；
- 使用唯一 nonce + 时间戳 + 签名防御重放攻击；
- 生产环境禁用裸 AES-CFB，优先选用 AEAD 模式（如 AES-GCM）。
✅ 验证示例（两端互通）
# Python 加密 → Go 解密
key = b"1234567890123456" # 16 bytes
enc = aes_cfb_encrypt(key, b"Hello from Python!")
print("Python encrypted:", enc)
# 将 enc 字符串传给 Go 服务端调用 Decrypt(...) → 应得 "Hello from Python!"// Go 加密 → Python 解密
key := []byte("1234567890123456")
enc, _ := Encrypt(key, []byte("Hello from Go!"))
fmt.Println("Go encrypted:", enc)
// 将 enc 字符串传给 Python 调用 aes_cfb_decrypt(...) → 应得 "Hello from Go!"只要 segment_size 统一为 128，密钥、IV、编码方式一致，Go 与 Python 的 AES-CFB 即可无缝互通。牢记：CFB 的互操作性核心在于 segment_size，而非“是否用了 CFB” —— 这是跨语言加密集成中最隐蔽也最关键的配置点。
