Qt客户端服务端应用树莓派4上DTLS握手dh key too small报错求解

该错误核心为树莓派服务端默认使用的Diffie-Hellman(DH)密钥交换参数长度低于Ubuntu 20.04客户端OpenSSL默认安全策略要求的最小长度（默认要求2048位及以上）。修改系统openssl.cnf未生效的常见原因是Qt网络模块默认不会加载系统OpenSSL全局配置，且若Qt为静态编译自带OpenSSL版本，系统配置完全不会生效。

方案1：修改服务端代码配置长DH参数（推荐生产环境使用） #

• 首先在树莓派上执行命令生成2048位及以上长度的DH参数文件：
  openssl dhparam -out dhparam.pem 2048
  生成耗时较长，等待执行完成即可。
• 在Qt DTLS服务端初始化代码中，显式将生成的DH参数加载到DTLS配置中，代码示例：

// 获取默认DTLS配置
QSslConfiguration dtlsConfig = QSslConfiguration::defaultDtlsConfiguration();
// 读取本地DH参数文件
QFile dhParamFile("你的dhparam.pem文件路径");
if (dhParamFile.open(QIODevice::ReadOnly)) {
    QByteArray dhData = dhParamFile.readAll();
    QSslDiffieHellmanParameters dhParams(dhData);
    if (dhParams.isValid()) {
        dtlsConfig.setDiffieHellmanParameters(dhParams);
    }
    dhParamFile.close();
}
// 将配置赋值给你的DTLS服务对象
yourDtlsServerInstance->setDtlsConfiguration(dtlsConfig);

该方案不会降低系统安全等级，兼容性最好。

方案2：降低客户端OpenSSL安全等级（仅测试用，不推荐生产环境） #

• 打开客户端/etc/ssl/openssl.cnf文件，在文件最开头添加如下配置：

openssl_conf = default_conf

[default_conf]
ssl_conf = ssl_sect

[ssl_sect]
system_default = system_default_sect

[system_default_sect]
MinProtocol = TLSv1.2
CipherString = DEFAULT@SECLEVEL=1

• 保存文件后重启客户端应用即可生效。该配置将全局OpenSSL安全等级降为1，允许使用1024位DH参数，会降低系统整体加密安全性。

执行openssl version查看树莓派系统OpenSSL版本，同时在Qt代码中打印QSslSocket::sslLibraryVersionString()确认Qt链接的OpenSSL版本与系统版本是否一致，若版本不匹配建议重新编译Qt适配系统OpenSSL版本，避免出现兼容性异常。

内容的提问来源于stack exchange，提问作者Kibermasternet