Fastify应用部署到Cloud Run后传长参数返回400、CORS配置无效如何解决

开发者阿泽

2026-9-29

问题根因

你看到的CORS报错是表象，真实错误是接口返回的400状态码：当URL长度超过限制时，Fastify会在请求进入CORS插件、路由处理逻辑之前，就直接返回400 Bad Request响应，这个响应没有被CORS插件处理，自然不会携带Access-Control-Allow-Origin头，浏览器就会抛出跨域拦截的提示。
触发400的核心原因是Fastify默认的URL长度限制，默认配置下maxUrlLength为8192字节，7400字符的参数如果包含中文、特殊编码字符，字节数会超过8KB的限制，直接被Fastify拦截返回400。
补充：你当前的CORS配置存在隐性问题：代码中直接判断/localhost/.test(origin)时，origin变量未从请求头中取值，判断逻辑完全不生效，只是这个问题不是长参数报错的诱因。

解决方案

方案1：调整Fastify长度限制（适配长URL参数场景）

创建Fastify实例时手动调高URL和查询字符串的长度上限，根据你的参数长度需求调整即可：

const fastify = require('fastify')({
  // 调整最大URL长度为16KB，可根据实际需求自定义
  maxUrlLength: 16384,
  // 同时调整查询字符串最大解析长度
  querystringMaxLength: 16384
})

方案2：修复CORS配置问题

补全请求头origin的取值逻辑，避免后续跨域配置失效：

fastify.register(require('@fastify/cors'), (instance) => (req, callback) => {
  // 从请求头取origin值，缺省为空字符串
  const origin = req.headers.origin || ''
  let corsOptions;
  if (/localhost/.test(origin)) {
    corsOptions = { origin: false }
  } else {
    corsOptions = { origin: true }
  }
  callback(null, corsOptions)
})

注：如果使用的是较新版本的Fastify生态，原fastify-cors包已更名为@fastify/cors，注意更换依赖包。