Objective-C转Swift项目中Moya请求报‘Parameter not found’问题排查

你遇到的这个问题我之前帮别人排查过，核心原因是Moya发送参数的编码格式和后端期望的不一致，具体分析和解决步骤如下：

问题根源分析 #

从你的PhTrackerAPI代码里能看到，POST请求（.login和.checkNumberExist）用的是JSONEncoding.default来编码参数：

return .requestParameters(parameters: parameters!, encoding: JSONEncoding.default)

这意味着Moya会把参数打包成JSON格式的请求体发送给后端，再加上你手动设置了Content-Type: application/json的请求头，后端收到的是纯JSON格式的数据。

但Postman默认发送POST请求时，通常用的是**application/x-www-form-urlencoded（表单编码）**格式，后端也是按照这个格式来解析参数的。当后端收到JSON格式的请求体时，无法识别出对应参数，就会抛出"Parameter not found"的错误。

解决方案 #

只需要把参数编码格式改成表单编码即可，具体修改如下：

1. 替换编码方式 #

把JSONEncoding.default换成URLEncoding.httpBody（POST请求推荐使用这个编码方式）：

public var task: Task {
    switch self {
    case .login, .checkNumberExist:
        return .requestParameters(parameters: parameters!, encoding: URLEncoding.httpBody)
    default:
        return .requestPlain
    }
}

2. 调整请求头（可选） #

因为URLEncoding.httpBody会自动设置正确的Content-Type为application/x-www-form-urlencoded，你可以选择：

• 去掉手动设置的Content-Type，让Moya自动处理请求头：

public var headers: [String: String]? {
    return nil
}

• 或者手动修改成表单编码对应的请求头：

public var headers: [String: String]? {
    return ["Content-Type": "application/x-www-form-urlencoded"]
}

额外验证点 #

如果修改后还是有问题，可以检查这两个细节：

• 确认参数键名和后端要求完全一致：比如你的.checkNumberExist用的是"phone"和"country_code"，要和Postman里成功请求的参数名完全匹配
• 确认parameters没有为空的情况：比如.login的参数是[:]，如果后端要求必须传某些参数，这里要补充完整

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