4. 开发环境搭建

做压测之前，得先把环境搭好。这事看着简单，可我在好几个项目里都见过有人在这上面卡一两天。说白了，你花半小时认真配好，后面能省出大把排查时间。我习惯先把整条链路想清楚，再动手。

4.1 操作系统选型

HSM SDK 官方支持 Linux 和 Windows，但两边差异不小。我个人建议：能用 Linux 就用 Linux。为什么？

• Linux 下 libpcsclite 和 openssl 安装起来一行命令搞定，没有路径空格和权限恶心事。
• Windows 下驱动签名、DLL 注册、环境变量重启这些事挺繁琐的。
• 压测工具（比如 JMeter、wrk、自定义 C 客户端）在 Linux 上更顺手。

如果你非得用 Windows，也不是不行。我在一个金融项目里就被客户要求 Windows Server 2019。嗯，折腾了一下午才把 PC/SC 驱动和 SDK 对上号。你想想看，同一套 SDK 在两边行为一致，但配置负担差不少。

对比项	Linux (建议)	Windows
HSM 驱动方式	pcsc-lite + 厂商驱动	PC/SC 原生 + 厂商 DLL
SDK 二进制格式	.so 库	.dll + .lib
环境变量生效	source / etc/profile	系统属性 → 重启终端
常见坑	udev 规则未配置	缺少 VC++ 运行库

4.2 SDK 安装

拿到 SDK 压缩包后，我习惯先在干净的目录里解压。

# Linux
mkdir -p /opt/hsm_sdk
cd /opt/hsm_sdk
tar -xzf ~/downloads/hsm_sdk_v3.2.1_linux_x64.tar.gz

# Windows
# 假设解压到 C:\HSM\SDK\v3.2.1

解压后目录结构大概长这样：

hsm_sdk/
├── bin/            # 工具和示例程序
├── include/        # C 头文件
├── lib/            # 运行时库 (.so / .dll)
├── samples/        # 示例代码
└── docs/           # 文档

我特别嘱咐一句：不要解压到带中文或空格的路径下。Windows 上尤其要注意，否则后续编译示例时会遇到诡异的路径解析错误。我去年帮一个客户排查，他解压到 "C:\Program Files\HSM SDK\"，结果 Makefile 里的空格把链接器搞崩了。

4.3 依赖库配置

SDK 本身依赖几个关键库。说白了，签名验签走的是 PKCS#11 或厂商私有接口，底层绕不开 OpenSSL 和 PC/SC。

Linux 依赖

# Ubuntu / Debian
sudo apt update
sudo apt install -y libpcsclite-dev pcscd openssl libssl-dev

# CentOS / RHEL
sudo yum install -y pcsc-lite-devel pcsc-lite openssl openssl-devel

# 启动 pcscd 服务
sudo systemctl enable pcscd
sudo systemctl start pcscd

安装后验证一下服务：

sudo systemctl status pcscd
# 确认 Active: active (running)

我遇到过一个问题：装了 libpcsclite-dev 但没安装 pcscd，结果 SDK 初始化时一直报 "SCARD_E_NO_SERVICE"。

Windows 依赖

• 安装 Visual C++ Redistributable（2015-2022 版本）。SDK 的 DLL 大多是 MSVC 编译的。
• 确认 Windows Smart Card Service 已启动。在 services.msc 里找到 "Smart Card" 服务，设为自动启动。
• 有些 HSM 厂商会提供单独的 PC/SC 驱动安装包，记得安装。

4.4 环境变量设置

环境变量配不对，你的程序根本找不到库和工具。我习惯把它写进配置文件里，永久生效。

Linux 设置（~/.bashrc 或 /etc/profile）

export HSM_SDK_HOME=/opt/hsm_sdk
export LD_LIBRARY_PATH=$HSM_SDK_HOME/lib:$LD_LIBRARY_PATH
export PATH=$HSM_SDK_HOME/bin:$PATH

# 如果 SDK 需要 PKCS#11 模块路径
export PKCS11_MODULE=$HSM_SDK_HOME/lib/libhsm_pkcs11.so

然后 source 一下：source ~/.bashrc

Windows 设置

• 此电脑 → 属性 → 高级系统设置 → 环境变量
• 新建系统变量 HSM_SDK_HOME，值为 C:\HSM\SDK\v3.2.1
• 在 Path 里添加 %HSM_SDK_HOME%\bin
• 在 PATH 里添加 %HSM_SDK_HOME%\lib（部分 SDK 需要）
• 创建变量 PKCS11_MODULE，值为 C:\HSM\SDK\v3.2.1\lib\hsm_pkcs11.dll

我给个建议： 设置完记得关掉所有 cmd 和终端再重开，因为它们读取的是进程启动时的快照。你不想看到路径明明加了但还是找不到吧？

4.5 验证环境是否就绪

搭完了得检验，不然心里不踏实。我通常会写一个最小的 SDK 初始化程序来验证。

先检查库是否能加载：

# Linux
ldd /opt/hsm_sdk/bin/hsm_tool | grep "not found"
# 如果有 not found，说明依赖库路径没配置对

# Windows
# 用 Dependency Walker 或直接运行一个示例 exe，看是否报缺少 DLL

然后运行 SDK 自带的测试工具（通常在 bin/ 下）：

# 列举连接的 HSM 设备 (假设工具叫 hsm_list)
hsm_list
# 正常输出类似：
# Device #0: SafeNet eToken 5110 (slot 0)
# Device #1: Thales Luna SA (IP: 192.168.1.100)

如果这一步报错，别慌。我列一下常见原因：

• 权限问题： Linux 下当前用户没有读 USB 设备的权限。可以加 udev 规则或直接 sudo 试试。
• 服务未启动： pcscd 没跑起来。
• SDK 版本不匹配： HSM 固件太老或太新，SDK 不支持。