如何为POCO HTTP Server配置CORS及自定义请求头以支持SPA？

看起来你碰到了CORS场景里很典型的自定义请求头识别问题，咱们一步步拆解排查：

• 先搞定OPTIONS预检请求的处理
  当浏览器发送带自定义头的请求时，会先发起一个OPTIONS预检请求，确认服务器允许这个头的存在。如果POCO Server没正确处理这个OPTIONS请求，后续的实际请求直接会被拦截。
  你需要在POCO的请求处理器里专门针对OPTIONS方法做响应，返回正确的CORS头：

  // 假设你用的是POCO的HTTPRequestHandler
  void handleRequest(HTTPServerRequest& request, HTTPServerResponse& response) override {
      // 优先处理OPTIONS预检请求
      if (request.getMethod() == HTTPRequest::HTTP_OPTIONS) {
          response.setStatus(HTTPResponse::HTTP_OK);
          response.add("Access-Control-Allow-Origin", "*");
          response.add("Access-Control-Allow-Methods", "GET, POST, PUT, DELETE, OPTIONS");
          // 这里必须明确写你的自定义头"username"，别用占位符！
          response.add("Access-Control-Allow-Headers", "origin, x-requested-with, content-type, username");
          response.add("Access-Control-Max-Age", "86400"); // 缓存预检结果，减少重复请求
          response.send();
          return;
      }
      // 处理实际业务请求
      response.add("Access-Control-Allow-Origin", "*");
      // 获取自定义头的值
      std::string username = request.get("username", ""); // 第二个参数是无值时的默认值
      // 后续业务逻辑...
  }
  

  划重点：你之前写的x-custom-header-here要替换成实际的username，这是最容易踩的坑！

• 确认前端请求头是否正确发送
  检查你的SPA代码里确实正确添加了username头，比如用fetch的例子：

  fetch('http://your-poco-server-address', {
      method: 'POST',
      headers: {
          'Content-Type': 'application/json',
          'username': 'user1' // 确保拼写完全正确，HTTP头大小写不敏感但尽量统一
      },
      body: JSON.stringify(yourRequestData)
  })
  

• 服务器端获取头的方式是否正确
  POCO的HTTPServerRequest::get()方法可以直接获取请求头，你可以先用request.has("username")判断头是否存在，再取值，避免空值问题。另外HTTP头本身不区分大小写，但尽量和前端发送的名称保持一致，减少不必要的麻烦。

• 清除浏览器缓存试试
  有时候浏览器会缓存之前的CORS响应，导致新的配置不生效。你可以打开浏览器开发者工具，在Network标签里勾选"Disable cache"，然后强制刷新页面重新测试。

• 排查是否有代理/中间件干扰
  如果你的SPA或POCO Server前面有反向代理（比如Nginx），要确保代理没有拦截或修改自定义请求头，同时代理返回的CORS响应头也和服务器配置一致。

按照上面的步骤调整后，应该就能解决自定义头不被识别的问题了。

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