📚 课程目录第1章 CDecrypt 概述

1. CDecrypt 概述：它到底是什么？

说起 CDecrypt，说实话我一开始接触它的时候也觉得名字挺唬人。其实就是一套用 C/C++ 写的对称加解密库，核心功能围绕着 AES、DES、SM4 这些算法转。你在项目里做数据传输加密、文件落盘保护、或者接口签名校验，十有八九会碰到它。

为什么专门要聊 CDecrypt 的日志？我个人习惯是：任何一个生产环境跑着的加解密模块，日志就是它的黑匣子。你想想看，加解密一旦出问题，数据要么解不出来，要么解出来是乱码，业务方直接炸锅。这时候如果没有日志复盘，你只能对着屏幕干瞪眼。

1.1 核心定位

CDecrypt 不是一个通用框架，它更像一个底层工具库。我经历过的一个项目里，业务端调用它加密用户手机号，服务端再用它解开做风控分析。说白了，它就是一个“锁”和“钥匙”的管家——给你提供标准接口，让你不用自己从头写 AES 轮函数。

我的小建议：刚开始用 CDecrypt 的人，容易把它当成万能丹。其实它的精确定位是对称加密运维层组件，非对称场景（比如 RSA）它不直接管，需要你自己拼装。

加密算法支持：AES-128/192/256、DES、3DES、SM4（国密）
操作模式：ECB、CBC、CTR、GCM（我强烈建议生产用 GCM，自带认证）
填充方式：PKCS7、ZeroPadding、NoPadding
调用方式：纯 C 接口 + C++ 封装类，跨平台

1.2 常见使用场景

说几个我实际踩过坑的场景，你感受一下：

场景	描述	日志关注点
API 请求加密	前后端用 CDecrypt 加密 JSON body	密钥版本、IV 是否随机、密文长度
配置文件脱敏	数据库密码用 CDecrypt 加密后存文件	解密失败次数、解密耗时
批量数据导出	CSV 文件逐行加密写入磁盘	写入 buffer 异常、分段边界
国密改造	原有 AES 切换 SM4，需要兼容旧数据	算法标识、密钥长度匹配

我曾经踩过的坑：一次生产事故，服务端用 CBC 模式加密，但每次 IV 写死了全零。结果黑客拿到几个密文样本直接推出来密钥。从那以后我强制要求：所有日志里必须打印 IV 来源（随机池/固定值），哪怕只是一个 debug 等级。

1.3 日志记录的意义——为了活着复盘

你可能觉得加解密嘛，不就是一个 API 调用，出问题了重新 encrypt 一次不就完了？真没这么简单。我遇到过一次诡异的情况：同一段明文、同一把密钥，在 A 机器上解密正常，在 B 机器上就抛出“padding error”。没有日志，你根本不知道 B 机器内存里某个字节被写坏了。

那日志到底该记什么？我把它分成三个维度：

入参快照：密钥索引、IV、算法标识、输入数据长度。注意，明文本身绝不能打日志，否则就等于泄露。
中间状态：内存分配是否成功、密钥扩展是否完成、上下文句柄是否有效。
结果特征：输出长度、返回码、耗时（毫秒级）。解密场景我会额外记“padding 校验结果”。

说白了，日志的意义就是让你能在不下线、不打断业务的情况下，复现出错的上下文。我一般还会把操作流水号（traceId）打进每条加解密日志，这样上下游调用链能串起来。

再讲一个我自己的习惯：把 CDecrypt 的日志级别分成三层。调试阶段开 DEBUG，线上只保留 INFO 和 WARN 以上。为什么？因为 AES 加密一个 1MB 的文件，DEBUG 日志可能会刷出上万行“S盒替换中间值”，磁盘很快就撑爆了。

// 我项目里常用的日志宏示例
#define CRYPT_LOG_DEBUG(...)  do { if (g_crypt_log_level <= LOG_DEBUG) \
    fprintf(log_fp, "[DEBUG][%s:%d] ", __FILE__, __LINE__), \
    fprintf(log_fp, __VA_ARGS__), fputc('\n', log_fp); } while(0)

// 线上只会看到：
// [INFO][cdecrypt_api.c:256] encrypt success: algo=AES-256-GCM, inLen=1024, outLen=1040,耗时=2ms
// 不会看到：
// [DEBUG][cdecrypt_core.c:178] round_key[0] = 0x2b7e1516

1.4 知识结构总览

下面这张图是我自己整理本章知识时画的，你可以把它当成一个“路线图”来理解：CDecrypt 日志到底覆盖哪些环节。

1.5 一个真实的日志教训

记得有一次线上告警，解密耗时突然从平均 2ms 飙到 500ms。我第一反应是算法变了？查日志发现：密钥索引从来没变，但有一台机器每次解密前都要花 300ms 去加载密钥文件。原来那台机器磁盘 IO 被打满了。

你看，如果没有日志里的“密钥加载耗时”字段，我根本不会把矛头指向 IO。这就是日志记录的意义——让不可见变成可见。后面章节我会详细讲如何设计日志字段、如何用日志反推异常根因。

小技巧：我每次上线新版本的加解密模块，都会先开一段时间的 DEBUG 日志（只记录到独立文件，不与业务日志混），等确认无异常再降级。这样即使出问题，也有最细粒度的现场。

1.6 本章小结

啰嗦了这么多，其实就是一句话：CDecrypt 不是银弹，日志才是你排查问题的眼睛。理解它的使用场景——哪些地方会产生日志、日志里应该记录什么、什么不能记录，这是整套课程的基础。别小看这些“常识”，我见过太多开发同学因为日志设计不合理，排查一个问题要翻好几天。