Linux环境下cpp-httplib实现的HTTPS服务器无法监听端口如何解决

• 修正宏定义顺序
  CPPHTTPLIB_OPENSSL_SUPPORT宏必须放在httplib.h的引入语句之前，无需手动引入openssl相关头文件，Windows专属的crypt32链接指令在Linux下无效可以直接删除，修改后代码开头示例：

#define CPPHTTPLIB_OPENSSL_SUPPORT
#include "httplib.h"
#include <iostream>

• 排查密钥文件路径问题
  Clion默认运行程序的工作目录是CMake输出的build目录，而非源码根目录，你代码中写的相对路径./keys/localhost.crt会从build目录下查找文件，找不到会直接导致SSLServer初始化失败。可以先替换为证书的绝对路径测试，确认是路径问题后，在Clion的运行配置里将工作目录修改为源码根目录即可。
• 增加错误判断逻辑
  SSLServer构造失败不会主动抛出异常，可通过is_valid()方法和listen()返回值判断运行状态，提前定位问题：

httplib::SSLServer svr("/你的证书绝对路径/localhost.crt", "/你的密钥绝对路径/localhost.key");
if (!svr.is_valid()) {
    std::cerr << "SSL服务初始化失败，请检查证书配置" << std::endl;
    return 1;
}

svr.Get("/hi", [](const auto&, auto& res) {
    res.set_header("Access-Control-Allow-Origin", "*");
    res.set_content("This is a test response", "text/plain");
});

std::cout << "start server..." << std::endl;
if (!svr.listen("0.0.0.0", 8080)) {
    std::cerr << "端口监听失败" << std::endl;
    return 1;
}

• 验证证书有效性
  可通过openssl命令确认证书和密钥匹配、格式合法：

# 验证证书格式
openssl x509 -in 你的证书路径.crt -text -noout
# 验证密钥格式
openssl rsa -in 你的密钥路径.key -check

• 排查绑定地址问题
  可以先将监听地址修改为0.0.0.0绑定所有网卡，排除机器网卡IP配置错误导致的监听失败问题。

内容的提问来源于stack exchange，提问作者Knöt