简介这是一份面向Windows开发者的C源码包使用Code::Blocks整合OpenSSL库完整实现RSA公钥私钥生成、加密、解密并结合Base64编码处理密文解决常见乱码问题。网络上很多OpenSSL RSA示例以Linux为主且常出现代码片段不全、依赖老旧、无法直接编译等困扰这套源码经过整理可直接在Windows下运行能明显减少环境配置和版本兼容的弯路。资源整体为RAR压缩包大小仅450KB共12个文件包含C源文件、头文件、Code::Blocks工程文件、编译中间文件以及已编译的EXE程序便于对照工程结构、查看依赖关系免去手动配置项目依赖的麻烦并可快速验证加解密效果。目前已有2926人学习下载适合正在学习OpenSSL编程或需要将RSA加密移植进Windows项目的读者作为参考。通过阅读和运行示例可以掌握RSA密钥生成、公钥加密、私钥解密以及Base64编码在C工程中的实际组合方式也可借此了解如何用Code::Blocks搭建带第三方库的Windows项目。 在Windows上用C做RSA加密解密听起来不算复杂——无非是调用OpenSSL的几个API但实际上这个需求从环境准备开始就处处有坑。头文件路径、lib库、运行时DLL的版本匹配、公钥私钥的格式差异任何一个环节不对都会让你在编译或者运行时报出一堆看不明白的错误。所以我这篇会以Windows平台为主线从OpenSSL拿到手开始一直到把加密、解密、签名、验签全部跑通为止期间遇到的报错和解决思路也一并整理进来。如果你是刚接触OpenSSL或者之前一直在Linux上开发、现在要转到Windows环境这篇文章应该能帮你少走不少弯路。1. RSA加密的核心思路先明白自己在加密什么1.1 非对称加密到底解决了什么问题RSA是目前用得最广泛的非对称加密算法所谓“非对称”是指加密和解密用的是两把不同的钥匙公钥负责加密私钥负责解密。公钥可以公开给任何人私钥必须自己保存好。这跟对称加密有很大区别对称加密就像一把钥匙既锁门又开门一旦钥匙泄露一切都白搭而非对称加密相当于门锁挂在外面谁都可以用公钥往门里塞信但只有持有私钥的人才能打开门取信。实际业务里RSA最常见的用途有三个一是加密传输对称密钥比如先用RSA加密一个AES密钥再用AES密钥加密真实数据也就是所谓的数字信封二是对关键字符串做签名防止内容被篡改三是做软件License、激活码之类的校验。因为RSA加密大文件太慢动不动就要几十毫秒甚至更久所以一般不会直接用RSA去加密几百KB以上的数据而是把它放在协议层、密钥交换层来用。1.2 公钥加密/私钥解密 vs 私钥签名/公钥验签很多初学者会在“加密解密”和“签名验签”上绕圈子总觉得公钥能加密那私钥也应该能加密吧实际上两者是反过来的。用公钥加密、私钥解密解决的是机密性问题保证只有持有私钥的人能看懂密文。用私钥签名、公钥验签解决的是完整性和身份认证问题接收方用公钥验证这段内容确实是私钥持有者发出的中间没有被替换过。我自己在项目里就吃过一次亏当时打算用私钥对消息做“加密”传给对方让对方用公钥“解密”结果OpenSSL根本没有这个方向的接口或者说即使能拼出来语义上也是错误的。正确的做法是需要保密就公钥加密私钥解密需要防篡改就私钥签名公钥验签。这两条路线别混不然后面排查起来会非常痛苦。1.3 填充模式别乱选PKCS#1与OAEPRSA加密对同样的明文每次输出的密文长度固定等于密钥长度比如2048位密钥加密后一定是256字节。密钥长度有限待加密的数据长度也有严格上限所以必须引入填充机制。OpenSSL里最常见的两种填充模式是RSA_PKCS1_PADDING和RSA_PKCS1_OAEP_PADDING。RSA_PKCS1_PADDING兼容性最好几乎所有语言、所有库都支持但是它在历史上暴露出过一些安全缺陷要求调用方对数据做严格校验。RSA_PKCS1_OAEP_PADDING在安全设计上更完善推荐新项目使用缺点是要求两端编程语言都支持OAEP否则会解密失败。实战里如果遇到“对端是Java/PHP/Go”这类跨语言场景先确认双方填充模式完全一致再联调加解密否则每次报错都会指向“密钥不对”很容易误导排查方向。2. Windows下OpenSSL环境配置版本、DLL和VS Code2.1 获取OpenSSL预编译包与版本选择在Windows上编译OpenSSL源码不是不行但那属于另一门折腾课普通人建议直接用网上编译好的预编译二进制包。网上有个叫slproweb的项目长期维护Windows版OpenSSL安装包装完后include、lib、bin目录一次齐全省去自己用Perl和MSVC编译的麻烦。版本选择方面我建议根据项目阶段来定。如果只是学习、跑通Demo用1.1.1 LTS也够用网上大多数教程和代码示例都基于1.1.1遇到问题容易搜到答案。如果是从零开始的新项目可以考虑3.x版本它提供了更现代的EVP接口很多老API被标记为deprecated。要注意的是3.x编译时相关旧接口会出警告如果你开了/WX把警告当错误处理就需要改用新的EVP_PKEY_*接口或者暂时把该项目改为不把警告当错误。我在下面提供的示例代码以1.1.1 API为主在3.x下编译会有警告但不影响运行。2.2 项目配置include、lib和运行库安装OpenSSL后默认路径大概是C:\Program Files\OpenSSL-Win64。在VS Code里配置C/C开发环境时需要做的核心事情就三件把include目录加进c_cpp_properties.json的includePath把lib目录加进库搜索路径在编译命令或tasks.json里链接libssl.lib和libcrypto.lib。如果用的是Visual Studio在项目属性里设置“附加包含目录”和“附加库目录”即可同时在“附加依赖项”里写上libssl.lib;libcrypto.lib。如果用VS Code的tasks.json大概是这样{ version: 2.0.0, tasks: [ { label: build, type: cppbuild, command: cl.exe, args: [ /EHsc, /I, C:/Program Files/OpenSSL-Win64/include, /Fo:${fileDirname}/build/, ${file}, /link, /LIBPATH:C:/Program Files/OpenSSL-Win64/lib, libssl.lib, libcrypto.lib, /OUT:${fileDirname}/build/${fileBasenameNoExtension}.exe ], problemMatcher: [$msCompile] } ] }有个非常重要的细节运行时需要把C:\Program Files\OpenSSL-Win64\bin下的libcrypto-3-x64.dll或libssl-3-x64.dll复制到可执行文件同级目录或者把bin目录加入系统PATH否则编译链接成功一运行就提示“缺少libcrypto-3-x64.dll”。很多人在这一步卡了很久还以为是代码写得不对。2.3 常见环境报错排查版本mismatch、Applink、缺DLL我在Windows上配置OpenSSL时遇到过三种最容易让人崩溃的报错。第一种是openssl version mismatch. built against 30000070, you have 30500050。这个报错的意思是编译时使用的头文件/库版本是3.0.7但运行时加载到的DLL是3.5.5。解决办法是把开发库和运行DLL完全对齐最直接的方式是下载同一套安装包然后从bin目录复制对应的DLL到exe目录不要混用系统PATH里其他版本的DLL。第二种是#error: OPENSSL_Applink或者no OPENSSL_Applink。这个错误通常发生在需要在多线程或文件流等场景下使用OpenSSL的FILE*接口时需要在项目中额外编译一个applink.c并链接进去。它位于源码目录的ms/applink.c或者在预编译安装包的include目录里可能没有需要去OpenSSL源码包中找。第三种是运行时报0xc000007b或“应用程序无法正常启动”。大概率是32位/64位架构不匹配比如你的程序编译成32位却链接了64位的OpenSSL库。此时把工程改为x64平台并确认链接的是lib目录下的64位库就能解决。3. 密钥生成与格式选择跨语言协作最容易翻车的地方3.1 PEM和DER、PKCS#1和PKCS#8的区别密钥文件有两种常见编码PEM是Base64文本带-----BEGIN xxx-----头DER是二进制格式不带头。绝大多数跨语言场景都用PEM因为便于传输、打印和日志排查。但PEM文本内部还有更细的区分。RSA私钥既可以存成PKCS#1格式也就是BEGIN RSA PRIVATE KEY也可以存成PKCS#8格式也就是BEGIN PRIVATE KEY公钥也可以分成BEGIN RSA PUBLIC KEY和BEGIN PUBLIC KEY两种。Java、Go等语言默认生成或解析的往往是PKCS#8OpenSSL命令行默认生成的RSA私钥通常是PKCS#1openssl rsa -pubout导出的公钥是PKCS#8的BEGIN PUBLIC KEY。这就导致一个问题你在C里用PEM_read_RSAPrivateKey读PKCS#8私钥返回nullptr或者用PEM_read_RSAPublicKey去读BEGIN PUBLIC KEY的公钥同样报错。报错信息可能千奇百怪像“rsa public key not find”这种提示本质就是格式不匹配。3.2 命令行一键生成密钥对命令行生成密钥对是我最推荐的方式一方面可以快速验证OpenSSL安装是否正常另一方面也能拿到标准的PEM文件用于测试。# 生成2048位RSA私钥PKCS#1格式 openssl genrsa -out private.pem 2048 # 从私钥导出公钥PKCS#8格式BEGIN PUBLIC KEY openssl rsa -in private.pem -pubout -out public.pem # 查看私钥信息确认是否有问题 openssl rsa -in private.pem -text -noout用这种方式生成的private.pem是BEGIN RSA PRIVATE KEYpublic.pem是BEGIN PUBLIC KEY。下面C代码在加载密钥时会分别用PEM_read_RSAPrivateKey和PEM_read_RSA_PUBKEY来对应解析。很多网上的例子把两种函数搞混了导致明明密钥文件是好的代码却报“bad decrypt”或“key reading error”。3.3 C代码生成密钥对并保存为PEM如果程序需要在运行时自动生成密钥对例如客户端本地生成一对密钥再上传公钥可以使用RSA_generate_key_ex。下面的代码生成2048位密钥对并把私钥保存为PKCS#1、公钥保存为PKCS#8格式#include openssl/rsa.h #include openssl/pem.h #include openssl/bn.h #include openssl/err.h #include cstdio #pragma comment(lib, libssl.lib) #pragma comment(lib, libcrypto.lib) bool generate_keypair(const char* private_file, const char* public_file, int bits 2048) { RSA* rsa RSA_new(); BIGNUM* e BN_new(); if (!BN_set_word(e, RSA_F4)) { // RSA_F4 65537 BN_free(e); RSA_free(rsa); return false; } if (!RSA_generate_key_ex(rsa, bits, e, nullptr)) { ERR_print_errors_fp(stderr); BN_free(e); RSA_free(rsa); return false; } FILE* fp fopen(private_file, wb); if (fp) { PEM_write_RSAPrivateKey(fp, rsa, nullptr, nullptr, 0, nullptr, nullptr); fclose(fp); } fp fopen(public_file, wb); if (fp) { PEM_write_RSA_PUBKEY(fp, rsa); // 输出 BEGIN PUBLIC KEY fclose(fp); } BN_free(e); RSA_free(rsa); return true; }这里要注意RSA生成密钥对时指数e尽量不要自己乱指定65537是绝大多数场景的默认安全选择。虽然理论上可以选择3或17但为了安全和兼容性建议用RSA_F4。另外生成密钥对是耗时操作2048位一般需要几十毫秒到几百毫秒如果在用户界面线程里直接调用界面可能会卡顿建议放到后台线程。4. 加解密与签名验签的完整C实现4.1 用公钥加密、私钥解密先实现密钥加载函数。读取私钥时用PEM_read_RSAPrivateKey读取公钥时如果公钥文件是BEGIN PUBLIC KEY必须用PEM_read_RSA_PUBKEY#include openssl/rsa.h #include openssl/pem.h #include openssl/err.h #include vector #include string #include iostream RSA* load_private_key(const char* file) { FILE* fp fopen(file, rb); if (!fp) return nullptr; RSA* rsa PEM_read_RSAPrivateKey(fp, nullptr, nullptr, nullptr); fclose(fp); return rsa; } RSA* load_public_key(const char* file) { FILE* fp fopen(file, rb); if (!fp) return nullptr; RSA* rsa PEM_read_RSA_PUBKEY(fp, nullptr, nullptr, nullptr); fclose(fp); return rsa; } void print_error() { ERR_print_errors_fp(stderr); } int rsa_encrypt(const std::string plain, std::string cipher, RSA* pubkey) { int rsa_len RSA_size(pubkey); std::vectorunsigned char buf(rsa_len); int ret RSA_public_encrypt( static_castint(plain.size()), reinterpret_castconst unsigned char*(plain.data()), buf.data(), pubkey, RSA_PKCS1_OAEP_PADDING); if (ret 0) { print_error(); return -1; } cipher.assign(reinterpret_castchar*(buf.data()), ret); return ret; } int rsa_decrypt(const std::string cipher, std::string plain, RSA* prikey) { int rsa_len RSA_size(prikey); std::vectorunsigned char buf(rsa_len); int ret RSA_private_decrypt( static_castint(cipher.size()), reinterpret_castconst unsigned char*(cipher.data()), buf.data(), prikey, RSA_PKCS1_OAEP_PADDING); if (ret 0) { print_error(); return -1; } plain.assign(reinterpret_castchar*(buf.data()), ret); return ret; }调用示例int main() { RSA* pubkey load_public_key(public.pem); RSA* prikey load_private_key(private.pem); if (!pubkey || !prikey) { std::cerr 加载密钥失败 std::endl; return -1; } std::string plain hello openssl rsa; std::string cipher, decrypted; if (rsa_encrypt(plain, cipher, pubkey) ! -1) { std::cout cipher size: cipher.size() std::endl; } if (rsa_decrypt(cipher, decrypted, prikey) ! -1) { std::cout decrypted: decrypted std::endl; } RSA_free(pubkey); RSA_free(prikey); return 0; }这里有个很重要的底层逻辑需要理解对2048位RSA来说使用OAEP填充时明文最多只能加密256 - 42 214个字节。为什么要减去42因为OAEP填充本身需要固定42字节的编码信息用于掩码和哈希。如果超过214字节RSA_public_encrypt会返回-1并提示data too large for key size。如果是PKCS#1填充则上限是256 - 11 245字节。这是初学者最容易踩的坑加密短字符串没问题一旦遇到超过限制的配置项、JSON串直接失败。4.2 用私钥签名、公钥验签签名验签的需求也很常见。签名时先对原文做哈希通常用SHA256再用RSA私钥对哈希值加密生成签名验证时用公钥解密签名得到哈希再与本地计算的哈希对比。从OpenSSL接口来看RSA_sign和RSA_verify内部会处理哈希摘要不需要我们手动拼接数据。用一个完整示例来说明#include openssl/evp.h #include openssl/rsa.h #include openssl/pem.h #include openssl/err.h #include vector #include string bool rsa_sign(const std::string data, std::string signature, RSA* prikey) { unsigned char hash[EVP_MAX_MD_SIZE]; unsigned int hash_len 0; if (!EVP_Digest(data.data(), data.size(), hash, hash_len, EVP_sha256(), nullptr)) { return false; } std::vectorunsigned char sig_buf(RSA_size(prikey)); unsigned int sig_len 0; int ret RSA_sign(NID_sha256, hash, hash_len, sig_buf.data(), sig_len, prikey); if (ret ! 1) { ERR_print_errors_fp(stderr); return false; } signature.assign(reinterpret_castchar*(sig_buf.data()), sig_len); return true; } bool rsa_verify(const std::string data, const std::string signature, RSA* pubkey) { unsigned char hash[EVP_MAX_MD_SIZE]; unsigned int hash_len 0; if (!EVP_Digest(data.data(), data.size(), hash, hash_len, EVP_sha256(), nullptr)) { return false; } int ret RSA_verify(NID_sha256, hash, hash_len, reinterpret_castconst unsigned char*(signature.data()), signature.size(), pubkey); return ret 1; }调用方式和加解密类似核心点是NID_sha256要和EVP_sha256()保持一致绝不能签名时用SHA256、验签时用SHA1。否则RSA_verify会返回0而且不会给你太明确的提示。4.3 字节流与Base64传输、长度限制RSA加密后的密文是二进制数据包含不可见字符如果直接拼进JSON、XML或者数据库字段轻则乱码重则被截断。实际项目里我通常会再套一层Base64编码把二进制密文变成可打印的ASCII字符串方便传输和存储。如果不想引入第三方Base64库OpenSSL本身也有EVP接口可以做Base64编码但代码稍微繁琐。实时上也可以用系统自带的CryptBinaryToStringA在Windows平台下很方便。这里提醒一下Base64编码会把字节数扩展约1/32048位RSA密文256字节Base64后大约344字符跨语言传输时字段长度一定要预留够否则对端截断后解密必然失败。此外数据加密不是越长越好RSA单次加密长度受填充模式限制。一旦需要加密的数据超过214字节OAEP或245字节PKCS#1不要幻想改大密钥长度就能一劳永逸更合理的做法是采用“RSA AES混合加密”用RSA加密随机生成的AES密钥用AES密钥加密真正的业务数据。既可以支持任意长度也能把RSA性能瓶颈对用户体验的影响降到最低。5. 常见问题与排查笔记我踩过的坑都在这里5.1 高频报错速查表报错或现象根本原因解决思路openssl version mismatch. built against 30000070, you have 30500050编译链接的库头文件版本与运行时DLL版本不一致把开发库和运行时DLL统一为同一套版本DLL务必放在exe同目录rsa public key not find密钥格式与读取函数不匹配或公钥文件损坏用openssl rsa -in private.pem -pubout重新导出公钥并确认程序的PEM读取函数对应正确格式no OPENSSL_Applink编译环境缺少applink.c支持常见于用FILE*操作密钥文件在工程中加入源码包里的ms/applink.c或改为使用BIO_new_file方式读取data too large for key size明文长度超过RSA单次加密上限改小明文长度或采用RSAAES混合加密、或者分段加密解密出来是乱码两端填充模式不一致或数据被Base64/编码层截断确认两端都使用OAEP或都使用PKCS#1检查密文长度是否等于RSA_size编译警告C4996fopen等MSVC认为fopen不安全项目里加_CRT_SECURE_NO_WARNINGS宏或改用fopen_s程序一运行就缺DLL没有部署OpenSSL运行库把bin目录下的libcrypto和libssl的DLL复制到exe所在目录5.2 排查思路与调试技巧遇到RSA相关报错我的排查顺序通常是这样先用命令行工具确认密钥文件本身没问题。openssl rsa -in private.pem -text -noout openssl pkey -in private.pem -check -noout openssl rsa -pubin -in public.pem -text -noout如果命令行能正常读取说明密钥文件没问题问题多半出在代码加载函数或格式匹配上。反之如果命令行都读取失败那就要重新生成密钥文件。同时在代码里不要只打印简单的“error”而是把OpenSSL内部错误队列打出来。上面示例里的ERR_print_errors_fp(stderr)就很关键它能输出类似error:04099079:rsa routines:RSA_padding_check_PKCS1_OAEP_mgf1:oaep decoding error这类具体信息。看到oaep decoding error基本可以确定是填充模式不匹配而不是密钥问题。5.3 部署时要特别注意的细节OpenSSL在Windows上的DLL依赖问题比Linux上要麻烦得多。Linux下通常用系统包管理器统一管理libssl不太需要关心DLL位置Windows上则必须手动带上DLL并且确保运行时使用的版本和编译时一致。建议在发布程序时把libcrypto-3-x64.dll和libssl-3-x64.dll放到exe同一个目录下不要指望目标机器装有OpenSSL。另外如果你的程序还被3.x版本的DLL影响比如同时引用了其他组件自带的OpenSSL库可能会出现不同版本DLL被同时加载的冲突。遇到这类问题可以使用Dependencies工具查看exe实际加载的DLL路径确认没有多版本混用。还有一个容易被忽略的点编译方式要与OpenSSL预编译包的运行库一致。slproweb提供的包默认使用MD动态链接运行库编译如果你的VS工程设置了MT静态链接运行库运行时会碰到奇奇怪怪的内存崩溃原因就是两边使用了不同版本的C/C运行库。解决办法是把项目运行库切换为“多线程DLL/MD”。我个人在实际调试中习惯先在命令行把密钥文件验证一遍再回头查代码把“密钥文件本身有没有问题”和“代码逻辑有没有问题”两个变量隔离开能省掉大量无意义的猜测。这套流程跑通之后后续再做RSAAES混合加密、数字信封、License签发等方案时底层细节就不需要再折腾了。如果你在Windows上用的是OpenSSL 3.x并且想摆脱deprecated警告下一步可以考虑把示例里的RSA系列接口换成EVP_PKEY_encrypt、EVP_PKEY_decrypt思路类似但参数组织上更统一也更符合新版本的推荐用法。本文还有配套的精品资源点击获取