NestJS如何正确处理含多查询参数的URL类型查询参数？

问题原因 #

当redirect_url本身包含&等查询参数分隔符时，未编码的URL会被HTTP解析器拆分为多个独立参数，导致@Query()只能拿到redirect_url的部分内容。以下是几种解决方法：

方法1：手动解析原始查询字符串 #

直接从请求对象中获取完整的查询字符串，通过正则提取目标参数的完整内容：

import { Controller, Get, Req } from '@nestjs/common';
import { Request } from 'express';
import * as url from 'url';

@Controller('api')
export class LoginController {
  @Get('login')
  login(@Req() req: Request) {
    const parsedUrl = url.parse(req.url);
    const queryStr = parsedUrl.query || '';
    
    // 匹配redirect_url=之后的所有内容
    const redirectMatch = queryStr.match(/redirect_url=(.*)/);
    const fullRedirectUrl = redirectMatch ? decodeURIComponent(redirectMatch[1]) : null;

    return {
      redirect_url: fullRedirectUrl
    };
  }
}

方法2：自定义管道复用逻辑 #

如果多个接口需要处理类似场景，可以封装一个管道统一处理：

// 自定义管道：ParseFullQueryParamPipe.ts
import { PipeTransform, Injectable, BadRequestException } from '@nestjs/common';
import { Request } from 'express';

@Injectable()
export class ParseFullQueryParamPipe implements PipeTransform {
  constructor(private readonly paramName: string) {}

  transform(_: any, metadata: any) {
    const req = metadata.data as Request;
    const queryStr = req._parsedUrl.query || '';
    const paramMatch = queryStr.match(new RegExp(`${this.paramName}=(.*)`));

    if (!paramMatch) {
      throw new BadRequestException(`缺少参数 ${this.paramName}`);
    }

    return decodeURIComponent(paramMatch[1]);
  }
}

在控制器中使用：

import { Controller, Get, Query } from '@nestjs/common';
import { ParseFullQueryParamPipe } from './parse-full-query-param.pipe';

@Controller('api')
export class LoginController {
  @Get('login')
  login(
    @Query('redirect_url', new ParseFullQueryParamPipe('redirect_url')) redirectUrl: string
  ) {
    return {
      redirect_url: redirectUrl
    };
  }
}

方法3：要求前端对redirect_url编码（推荐长期方案） #

从HTTP规范来说，查询参数中的特殊字符（如&、?）必须编码。前端使用encodeURIComponent对redirect_url编码后再拼接请求：

const targetRedirectUrl = 'http://localhost:3000/api/schemas/generate?appId=application&event=eventName&registry=registry';
const encodedUrl = encodeURIComponent(targetRedirectUrl);
const loginRequestUrl = `http://localhost:3000/api/login?redirect_url=${encodedUrl}`;

此时后端直接用@Query('redirect_url')即可获取完整的解码后地址，NestJS会自动处理解码逻辑。

内容的提问来源于stack exchange，提问作者mykhailo.vz