如何从Flutter向Node.js传递多个查询参数？附代码示例

一、Flutter端：正确传递查询参数 #

你当前的Dart代码没有携带city、date、location参数，需要通过URL查询参数的方式传递，推荐用Uri的queryParameters构造方法，避免手动拼接URL时出现编码错误：

Future<Appointment> searchSingleAppointment({
  required BuildContext context,
  required String city,
  required String date,
  required String location,
}) async {
  Appointment appointment = Appointment(id: '', city: '', date: '', location: '', appointmentStatus: '', queue: 0);
  try {
    // 构建带查询参数的URI
    final uri = Uri.parse('$uri/appointments/search').replace(
      queryParameters: {
        'city': city,
        'date': date,
        'location': location,
      },
    );

    http.Response res = await http.get(
      uri,
      headers: {
        'Content-Type': 'application/json; charset=UTF-8',
        // 'x-auth-token': userProvider.user.token, // 鉴权需求可开启
      },
    );

    httpErrorHandle(
      response: res,
      context: context,
      onSuccess: () {
        appointment = Appointment.fromJson(jsonDecode(res.body)); // 先解析JSON字符串为Map
      },
    );
  } catch (e) {
    showSnackBar(context, e.toString());
  }
  return appointment;
}

注意：原代码中直接用res.body传入fromJson会报错，需先用jsonDecode将字符串转为Map格式。

二、Node.js端：接收参数并执行MongoDB查询 #

后端要从req.query（而非req.params）中获取查询参数，构建精准的MongoDB查询条件，同时增加基础校验：

appointmentRouter.get("/appointments/search", async (req, res) => {    
  try {
    // 提取查询参数
    const { city, date, location } = req.query;

    // 构建查询条件：仅保留非空参数
    const query = {};
    if (city) query.city = city;
    if (date) query.date = new Date(date); // 若MongoDB中date是Date类型，需转换格式
    if (location) query.location = location;

    // 执行单条查询（若需多条结果，替换为find(query)）
    const appointment = await Appointment.findOne(query); 

    if (!appointment) {
      return res.status(404).json({ error: "未找到匹配的预约记录" });
    }

    res.json(appointment);
  } catch (e) {
    res.status(500).json({ error: e.message });
  }
});

说明：

• req.params用于获取URL路径参数（如/appointments/:id中的id），查询参数（?city=xxx&date=xxx）需用req.query获取。
• 如果MongoDB的date字段存储为Date类型，必须将前端传的字符串转为Date对象，否则会匹配失败。
• 用findOne对应前端返回单个Appointment的逻辑，若需多条结果，需同步修改前端的接收逻辑。

三、关键优化点 #

• 参数校验：前端先校验参数非空再发起请求，后端可使用joi等库做格式校验（比如日期合法性）。
• 安全防护：使用Mongoose的查询构造器自动规避NoSQL注入风险，禁止直接拼接查询字符串。
• 错误处理：后端补充未找到数据的404响应，前端对应处理该状态码，给用户明确提示。
• 编码兼容：通过Uri的queryParameters自动处理特殊字符编码，避免中文或特殊符号传递失败。

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