使用cppcms 1.2引入静态资源遇404错误，求文档根目录配置方法

我之前在使用CppCMS 1.2的时候也踩过静态资源找不到的坑，结合官方特性和实操经验给你梳理清楚：

核心结论：CppCMS的文档根目录不是默认的应用根目录 #

你直接把media放在应用根目录却访问不到，就是因为CppCMS不会自动把应用根目录当作静态资源的根目录，必须手动配置。

1. 配置文档根目录 #

你需要通过代码或者配置文件明确指定静态资源的存放路径：

• 代码中配置：在初始化CppCMS服务的时候添加设置

cppcms::service srv(argc, argv);
// 这里可以用绝对路径，也可以用相对于应用运行目录的相对路径
srv.settings().set("http.document_root", "./media");

• 配置文件中设置（比如用JSON格式的config.json）：

{
  "http": {
    "document_root": "./media"
  }
}

⚠️ 注意：这里的路径是相对于你运行应用的工作目录，不是编译生成的CMakeFiles目录！你之前复制到CMakeFiles没用，就是因为运行应用时的工作目录大概率不是那里。

2. 映射静态资源路由 #

光设置文档根还不够，你需要告诉CppCMS哪些URL路径对应静态资源。比如要让/media/*的请求指向静态文件，可以这样做：

• 代码中挂载静态路由：

// 在应用初始化代码里添加
srv.applications_pool().mount("/media", cppcms::static_files("./media"));

• 配置文件中配置：

{
  "applications": [
    {
      "mount": "/media",
      "static": "./media"
    }
  ]
}

这样当你访问localhost:8080/media/style.css时，CppCMS就会去指定的media目录里查找对应的文件了。

3. 排查问题的小技巧 #

• 优先用绝对路径配置document_root，避免相对路径带来的工作目录问题，比如/home/yourname/your-project/media
• 查看CppCMS的启动日志，里面会输出加载的配置信息，确认document_root是否正确设置
• 检查media文件夹及其文件的权限，确保运行应用的进程有读取权限

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