使用 cpp-httplib 发布静态文件服务
1. 引言
静态文件（Static Files） 是指那些内容在服务器上预先写好、不会随请求动态改变的文件，例如：
HTML 页面（如 index.html）
CSS 样式表（如 style.css）
JavaScript 脚本（如 app.js）
图片（如 logo.png, photo.jpg）
字体、图标、PDF、音视频等
静态文件服务（Static File Serving） 是指 HTTP 服务器能够接收客户端（如浏览器）对某个路径的请求，并自动从本地文件系统中找到对应文件，将其内容返回给客户端。例如：
服务器自动去磁盘找 ./www/style.css
读取文件内容，设置正确的 Content-Type: text/css
把文件原样返回给浏览器
这个过程无需写任何业务逻辑代码，由 HTTP 服务器框架自动完成。
一个通用的 HTTP 服务器框架通常会提供静态文件服务功能，因为：
实现简单：读文件 + 设置 MIME 类型即可；
用途广泛：极大简化小型项目部署；
开发体验好：不用额外起 Nginx 就能跑完整 Web 应用；
符合 HTTP 本质：HTTP 最初就是为传输静态文档设计的（超文本传输协议）。
2. 实例
使用 cpp-httplib 发布静态文件服务非常简单：
#include <httplib.h>
#include <iostream>
#include <string>
using namespace std;
int main() {
httplib::Server svr;
svr.set_mount_point("/public", "D:/Work/HttpServer/public");
std::cout << "Server listening on http://0.0.0.0:8080/public\n";
svr.listen("0.0.0.0", 8080);
return 0;
}在 D:/Work/HttpServer/public 这个目录中笔者放置了一些文件：
那么可以在浏览器通过 URL 地址 http://127.0.0.1:8080/public/最小二乘问题详解1：线性最小二乘/meta.json 访问到具体的文件内容：
那么是不是所有的文件都支持访问并且加载显示呢？这取决于 HTTP 服务器（cpp-httplib）对文件扩展名与 MIME 类型的映射能力：
3. 扩展
set_mount_point 是 cpp-httplib 用于发布静态文件服务的接口，将设置的目录挂载到 HTTP Get 请求。如果将代码写的更加本质一点，就是读取相应的数据，将数据填充到 Get 请求返回：
#include <httplib.h>
#include <filesystem> // C++17
#include <fstream>
#include <iostream>
#include <nlohmann/json.hpp>
#include <string>
using namespace std;
namespace fs = std::filesystem;
// 辅助函数：根据文件扩展名返回 MIME 类型
std::string get_mime_type(const std::string& filename) {
if (filename.ends_with(".md")) {
return "text/markdown; charset=utf-8";
} else if (filename.ends_with(".json")) {
return "application/json; charset=utf-8";
} else if (filename.ends_with(".txt")) {
return "text/plain; charset=utf-8";
}
// 默认 fallback
return "application/octet-stream";
}
int main() {
httplib::Server svr;
std::u8string docRoot =
u8"D:/Work/HttpServer/public/最小二乘问题详解1：线性最小二乘";
// 路由：GET /files/<filename>
svr.Get(R"(/files/([^/]+))", [&](const httplib::Request& req,
httplib::Response& res) {
// 提取文件名（来自正则捕获组）
std::string filename = req.matches[1];
std::u8string u8Filename(filename.begin(), filename.end());
// 安全检查：防止路径穿越（如 ../../etc/passwd）
if (filename.find("..") != std::string::npos || filename.empty()) {
res.status = 400;
res.set_content(R"({"error": "Invalid filename"})", "application/json");
return;
}
// 构建完整路径
fs::path filepath = fs::path(docRoot) / u8Filename;
// 检查文件是否存在且是普通文件
if (!fs::exists(filepath) || !fs::is_regular_file(filepath)) {
res.status = 404;
res.set_content(R"({"error": "File not found"})", "application/json");
return;
}
// 读取文件内容
std::ifstream file(filepath, std::ios::binary);
if (!file) {
res.status = 500;
res.set_content(R"({"error": "Failed to read file"})",
"application/json");
return;
}
std::string content((std::istreambuf_iterator<char>(file)),
std::istreambuf_iterator<char>());
// 设置 Content-Type
std::string mime = get_mime_type(filename);
res.set_content(content, mime);
});
std::cout << "Server listening on http://0.0.0.0:8080/files/<filename>\n";
svr.listen("0.0.0.0", 8080);
return 0;
}如果我们在浏览器地址访问http://127.0.0.1:8080/files/最小二乘问题详解1：线性最小二乘.md，就可以看到最小二乘问题详解1：线性最小二乘.md这个文件的内容：
这是因为这里将 .md 文件的 MIME 设置成了 text/markdown，浏览器会按照文本格式显示 .md 文件的内容。而在 set_mount_point 接口中，由于不识别 .md 格式类型，MIME 类型会回退回 application/octet-stream ，也就是二进制文件 / 未知类型，浏览器会强制下载。