使用 Headless CMS 时碰到的 CORS 问题及解决方法

阅读时长 7 分钟读完

随着前端开发的不断发展,对于 CMS (Content Management System) 的要求也越来越高,特别是对于 Headless CMS。Headless CMS 只提供数据,而不提供页面,因此可以方便地将数据与任何前端技术结合使用,提高了前端开发的自由度。但是在实际开发过程中,我们可能会遇到 CORS (Cross-Origin Resource Sharing) 问题。

本文将介绍 Headless CMS 中可能出现的 CORS 问题及解决方法,帮助开发者更好地使用 Headless CMS。

CORS 是什么?

CORS 是浏览器的一种安全策略,用于限制不同源(协议、域名、端口)之间的网络请求。一般来说,浏览器只允许发起同源的网络请求,但是在一些跨域场景下,例如前端使用 Headless CMS,我们需要发起跨域的请求。此时,浏览器会对请求进行判断,如果不满足安全策略要求,就会阻止请求,从而导致前端无法正常使用 Headless CMS。

实际场景

假设我们使用 Prismic 作为 Headless CMS,并且在前端使用 Vue.js 框架开发,那么可能会出现以下的代码:

-- -------------------- ---- -------
-- - --- ----- ------- --
----------
  -----
    ------ -------------- -------
  ------
-----------

--------
  ------ ----- ---- --------

  ------ ------- -
    ------ -
      ------ -
        --------- --
      -
    --

    --------- -
      ----- ----------- - -----------------------------------------------------------------
      ----- --------- - ------------------------------------------------------------------------------------------------------------------------
      ----- -------- - -
        -- ----- - ----------------- ------------------
        ---------- ------------------- -------
        --------- ---
        ----- -
      --
      ---------------------- -
        -------- -
          ---------------- ------ -------------
        --
        ------- --------
      --
        -------------- -- -
          ------------- - -------------------------
        --
        ------------ -- -
          --------------------
        --
    -
  -
---------

这段代码会向 Prismic API 发送请求,获取数据并展示在页面上。但是当我们运行代码时,可能会遇到以下错误信息:

这是因为浏览器对请求进行了安全检查,发现请求的源和目标不同,因此阻止了请求。如果我们不解决这个问题,那么页面上将无法显示任何数据。

解决方法

方法一:在 Headless CMS 中进行配置

一些 Headless CMS 支持在管理页面中进行 CORS 配置。例如,在 Prismic 中可以通过以下方式进行配置:

  1. 登录 Prismic 后台,进入 repository 设置页面
  2. 在左侧导航栏中选择 CORS
  3. 填写合法的 Origin 字符串,例如 http://localhost:8080

这样设置后,Prismic 就会允许来自指定 Origin 的前端请求。

方法二:使用代理服务器

我们可以使用代理服务器,将跨域请求转发到本地服务器,从而绕过浏览器的安全策略。这种方法需要在本地搭建代理服务器,较为麻烦。

以下是一个使用 Node.js 的本地服务器示例:

-- -------------------- ---- -------
----- ------- - -------------------
----- ----- - -----------------
----- --- - ----------

----- ----------- - -----------------------------------------------------------------
----- --------- - ------------------------------------------------------------------------------------------------------------------------
----- -------- - -
  -- ----- - ----------------- ------------------
  ---------- ------------------- -------
  --------- ---
  ----- -
--

---------------------- ----- ----- ---- -- -
  --- -
    ----- -------- - ----- ---------------------- -
      -------- -
        ---------------- ------ -------------
      --
      ------- --------
    ---
    ------------------------
  - ----- --- -
    -----------------
    ---------------------- ------ --------- ------ ------ ---
  -
---

---------------- -- -- -
  ------------------- --------- -- ---- -------
---

在这个示例中,我们创建了一个 Node.js 服务器,并监听 8080 端口。当访问 /api/search 时,服务器会向 Prismic API 发送带有身份验证信息的请求,并将结果返回给前端。

此时在前端中,我们只需要将 API 请求的地址修改为我们的本地服务器地址即可:

-- -------------------- ---- -------
--------- -
  ----- ----------- - -----------------------------------
  ----------------------
    -------------- -- -
      ------------- - -------------------------
    --
    ------------ -- -
      --------------------
    ---
-

使用代理服务器的方法比较复杂,但是可以绕过浏览器的限制,适用于一些比较复杂的场景。

总结

本文介绍了 Headless CMS 使用中可能出现的 CORS 问题及解决方法。我们可以通过 Headless CMS 的配置或者使用代理服务器来解决问题。在实际开发中,我们需要根据情况选择合适的方法。同时,在使用 Headless CMS 时,还需了解安全限制等相关知识,以避免出现安全问题。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/647af0c3968c7c53b06895f8

纠错
反馈