React迁移PHP页面：RTK Query跨域传递PHP Session Cookie问题

先排查几个关键配置有没有漏，你已经做了部分设置，可能还有细节没到位：

1. 修正PHP Session Cookie的属性 #

PHP默认的PHPSESSID Cookie带SameSite=Lax属性，跨域时会被浏览器拦下来。得改PHP的Session配置，让Cookie允许跨域发送：

• 在session_start()之前加这段代码：

  session_set_cookie_params([
      'lifetime' => 0,
      'path' => '/',
      'domain' => '.your-domain.com', // 用通配符覆盖主域下所有子域，比如api.your-domain.com和react.your-domain.com
      'secure' => true, // 生产环境必须开HTTPS，不然SameSite=None不生效
      'httponly' => true,
      'samesite' => 'None' // 核心：跨域场景必须设为None，还要配合secure=true
  ]);
  session_start();
  

  划重点：SameSite=None和secure=true必须同时开启，不然浏览器不会认可这个Cookie。

2. 确认RTK Query的credentials配置全量生效 #

• 如果是全局配置API切片，要确保credentials: 'include'写在fetchBaseQuery里，这样所有请求都会自动带Cookie：

  import { createApi, fetchBaseQuery } from '@reduxjs/toolkit/query/react';
  
  const api = createApi({
    baseQuery: fetchBaseQuery({
      baseUrl: 'https://api.your-domain.com',
      credentials: 'include', // 全局生效，不用每个接口单独写
    }),
    endpoints: (builder) => ({
      // 你的接口定义
    }),
  });
  

• 如果是单个接口单独配置，每个需要传Cookie的接口都得加上credentials: 'include'：

  endpoints: (builder) => ({
    fetchData: builder.query({
      query: () => ({
        url: '/data',
        credentials: 'include', // 单个接口的配置
      }),
    }),
  }),
  

3. 后端CORS配置再核对一遍 #

除了已经设置的Access-Control-Allow-Origin和Access-Control-Allow-Credentials，还要注意：

• 绝对不能设Access-Control-Allow-Origin: *，必须是你前端的具体域名（你已经做了，确认是完整的HTTPS域名就行）
• 如果请求带自定义头，得在后端加Access-Control-Allow-Headers允许对应的头，但默认的Cookie头一般不用额外配置
• 可以加个Access-Control-Expose-Headers，方便前端读取后端返回的Cookie相关头（可选，调试的时候有用）

4. 用浏览器工具验证配置 #

打开F12开发者工具：

• 切到Application标签，看Cookies里有没有PHPSESSID，检查Domain、SameSite、Secure属性是不是和你配置的一致
• 切到Network标签，看RTK Query发送的请求，Request Headers里有没有Cookie: PHPSESSID=xxx这一行
• 如果没有，再看Response Headers里的Set-Cookie，确认后端有没有正确设置Session Cookie

把这些配置都搞定，RTK Query就能自动带上PHP Session Cookie，完全不用通过GET/POST参数传递，正好符合你的需求。

内容的提问来源于stack exchange，提问作者Tim Nikischin