Swift向Express传递查询字符串时Int转为String的问题

核心原因 #

HTTP URL的查询参数本质上只有字符串格式，不管你在客户端传的是数字、布尔值还是其他类型，到服务端都会被解析成字符串——这是HTTP协议的固有特性，不是Swift或Express的bug。

第一步：修正Swift端的查询字符串拼接代码 #

你原有的拼接代码存在变量未定义（content、i）和缺少URL编码的问题，以下是正确实现：

let params: [String: Any] = ["id": 1, "age": 25]
var queryComponents = [String]()

for (key, value) in params {
    // 将参数值转为字符串并做URL编码，避免特殊字符导致的解析错误
    guard let encodedValue = "\(value)".addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed) else {
        continue
    }
    queryComponents.append("\(key)=\(encodedValue)")
}

// 拼接成完整的查询字符串
let queryString = queryComponents.joined(separator: "&")
// 构造请求URL
guard let requestUrl = URL(string: "http://localhost:8080/api?" + queryString) else {
    fatalError("无法构造有效URL")
}

var request = URLRequest(url: requestUrl)
request.setValue("application/x-www-form-urlencoded", forHTTPHeaderField: "Content-Type")

do {
    let (data, response) = try await URLSession.shared.data(for: request)
    // 后续处理响应数据
} catch {
    // 处理请求错误
}

第二步：在Express端将字符串转换为Int类型 #

既然查询参数本身是字符串，需要在服务端主动转换为目标类型，同时处理转换失败的场景：

方式1：手动转换（基础场景）

app.get('/api', (req, res) => {
    // 使用parseInt转换，第二个参数指定十进制
    const id = parseInt(req.query.id, 10);
    // 校验转换结果，避免非数字参数
    if (isNaN(id)) {
        return res.status(400).send("id参数必须是整数");
    }
    // 此时id为number类型
    console.log(typeof id); // 输出 "number"
    res.send({ id: id });
});

方式2：用验证中间件规范处理（推荐）

使用express-validator这类库可以更优雅地做参数校验和类型转换：

const { query, validationResult } = require('express-validator');

app.get('/api', [
    // 校验id必须是整数，自动转换为number类型
    query('id').isInt().withMessage("id必须是整数")
], (req, res) => {
    // 检查校验结果
    const errors = validationResult(req);
    if (!errors.isEmpty()) {
        return res.status(400).json({ errors: errors.array() });
    }
    // req.query.id已自动转为number类型
    const id = req.query.id;
    console.log(typeof id); // 输出 "number"
    res.send({ id: id });
});

总结 #

客户端无法强制服务端接收非字符串类型的查询参数，核心解决方案是：

1. Swift端保证参数值正确拼接并完成URL编码
2. Express端根据业务需求，将字符串类型的查询参数转换为目标数据类型

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