求助：Groovy中HttpURLConnection发送表单编码POST请求返回403

你的Groovy代码使用HttpURLConnection返回403错误，但其他工具/库可以正常请求，核心原因大概率是请求格式或请求头缺失，以下是具体排查点和修正方案：

1. 最关键问题：参数分隔符错误 #

你代码中的参数字符串使用了&（HTML转义字符），但application/x-www-form-urlencoded格式要求参数之间用&直接分隔。&会被服务器解析为参数值的一部分，导致参数格式完全错误，触发403拦截。

错误写法：

"client_id=client_id&username=username&password=password&scope=api&grant_type=password"

正确写法：

"client_id=client_id&username=username&password=password&scope=api&grant_type=password"

2. 补充必要请求头 #

很多服务器会拦截缺少关键请求头的请求，HttpURLConnection的默认请求头比较简陋，而Unirest/Postman会自动添加这些头：

• Content-Length：明确告诉服务器请求体的字节长度，避免服务器因无法确定长度而拒绝请求
• User-Agent：模拟合法客户端标识，避免被反爬/安全策略拦截

3. 正确处理输出流 #

写完请求体后需要flush()并关闭输出流，确保所有数据都发送到服务器，避免数据不完整导致的错误。

修正后的完整代码 #

def postData = "client_id=client_id&username=username&password=password&scope=api&grant_type=password".getBytes("UTF-8")
HttpURLConnection conn = new URL("https://url").openConnection()
try {
    conn.setDoOutput(true)
    conn.setRequestMethod("POST")
    conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded")
    // 添加Content-Length头
    conn.setRequestProperty("Content-Length", String.valueOf(postData.length))
    // 添加User-Agent头，模拟常用客户端
    conn.setRequestProperty("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36")

    def os = conn.getOutputStream()
    os.write(postData)
    os.flush()
    os.close()

    def responseCode = conn.getResponseCode()
    println "响应码: $responseCode"
    
    // 读取响应内容，排查具体错误信息
    if (responseCode == 200) {
        println new BufferedReader(new InputStreamReader(conn.getInputStream())).text
    } else {
        println "错误详情: " + new BufferedReader(new InputStreamReader(conn.getErrorStream())).text
    }
} finally {
    conn.disconnect()
}

额外排查建议 #

如果修改后仍返回403，建议读取服务器的错误流内容（代码中已包含），服务器通常会返回具体的拒绝原因，比如"缺少某个请求头"、"参数校验失败"等，帮助进一步定位问题。

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