Java实现带Basic认证的x-www-form-urlencoded参数POST请求获取响应

实现逻辑核心是同时满足两个HTTP请求规范：一是将Basic身份认证信息按格式加入请求头，二是按表单格式构造并发送请求体，以下是两种常用场景的可落地代码实现。

核心实现逻辑说明 #

• Basic身份认证的标准格式：将用户名:密码字符串做Base64编码后，放入请求头Authorization字段，值的格式为Basic 编码后的字符串
• x-www-form-urlencoded格式要求：请求头Content-Type必须声明为application/x-www-form-urlencoded，请求体内容为经过URL编码的键值对，多个参数之间用&连接，格式为key1=value1&key2=value2

方案1：JDK原生HttpURLConnection实现（无额外第三方依赖） #

适合不需要引入额外HTTP客户端依赖的轻量场景，直接使用JDK自带能力完成请求发送。

import java.io.*;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.Base64;
import java.util.Map;
import java.util.stream.Collectors;

public class FormPostWithBasicAuth {
    public static void main(String[] args) throws IOException {
        // 替换为实际目标接口地址
        String targetUrl = "https://your-target-api.com";
        // 替换为实际BasicAuth凭证
        String username = "test_user";
        String password = "test_pass_123";
        // 替换为实际需要传递的表单参数
        Map<String, String> formParams = Map.of(
                "username", "zhangsan",
                "nickname", "张三 测试账号!@#$"
        );

        // 拼接符合格式要求的表单请求体
        String formBody = formParams.entrySet().stream()
                .map(entry -> {
                    try {
                        return URLEncoder.encode(entry.getKey(), StandardCharsets.UTF_8) +
                                "=" +
                                URLEncoder.encode(entry.getValue(), StandardCharsets.UTF_8);
                    } catch (Exception e) {
                        throw new RuntimeException("表单参数URL编码失败", e);
                    }
                })
                .collect(Collectors.joining("&"));

        // 初始化HTTP连接
        URL url = new URL(targetUrl);
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        try {
            conn.setRequestMethod("POST");
            conn.setDoOutput(true);
            conn.setConnectTimeout(10000);
            conn.setReadTimeout(10000);

            // 设置请求头：声明表单格式
            conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded;charset=UTF-8");
            // 构造并设置BasicAuth请求头
            String authRawContent = username + ":" + password;
            String encodedAuth = Base64.getEncoder().encodeToString(authRawContent.getBytes(StandardCharsets.UTF_8));
            conn.setRequestProperty("Authorization", "Basic " + encodedAuth);

            // 写入请求体内容
            try (OutputStream os = conn.getOutputStream();
                 OutputStreamWriter osw = new OutputStreamWriter(os, StandardCharsets.UTF_8)) {
                osw.write(formBody);
                osw.flush();
            }

            // 读取响应结果
            int responseCode = conn.getResponseCode();
            InputStream inputStream = responseCode >= 200 && responseCode < 300 ?
                    conn.getInputStream() : conn.getErrorStream();
            String responseContent;
            try (BufferedReader br = new BufferedReader(new InputStreamReader(inputStream, StandardCharsets.UTF_8))) {
                responseContent = br.lines().collect(Collectors.joining(System.lineSeparator()));
            }

            System.out.println("响应状态码：" + responseCode);
            System.out.println("响应内容：" + responseContent);
        } finally {
            conn.disconnect();
        }
    }
}

实现注意事项 #

• 表单参数的键和值必须使用UTF-8做URL编码，不能直接拼接原始字符串，否则带空格、特殊字符、中文的参数会被服务端解析错误
• BasicAuth编码时不要对用户名:密码的拼接字符串做额外的格式转换，直接取原始字节做标准Base64编码即可
• 必须显式设置Content-Type请求头，否则服务端可能无法正确识别请求体格式

方案2：OkHttp客户端实现（项目已引入HTTP客户端依赖场景） #

适合日常项目开发场景，成熟客户端会自动处理格式编码、异常重试等通用逻辑，代码更简洁。

import okhttp3.*;
import java.util.concurrent.TimeUnit;

public class OkHttpFormPostDemo {
    public static void main(String[] args) throws Exception {
        OkHttpClient client = new OkHttpClient.Builder()
                .connectTimeout(10, TimeUnit.SECONDS)
                .readTimeout(10, TimeUnit.SECONDS)
                .build();

        // 构造符合x-www-form-urlencoded规范的请求体，OkHttp会自动完成参数编码
        RequestBody formBody = new FormBody.Builder()
                .add("username", "zhangsan")
                .add("nickname", "张三 测试账号!@#$")
                .build();

        // 构造请求，OkHttp内置的Credentials.basic方法会自动完成BasicAuth的编码逻辑
        Request request = new Request.Builder()
                .url("https://your-target-api.com")
                .post(formBody)
                .header("Authorization", Credentials.basic("test_user", "test_pass_123"))
                .build();

        // 发送请求并获取响应
        try (Response response = client.newCall(request).execute()) {
            String responseStr = response.body().string();
            System.out.println("响应状态码：" + response.code());
            System.out.println("响应内容：" + responseStr);
        }
    }
}

实现注意事项 #

• OkHttp的FormBody会自动完成所有参数的URL编码，不需要手动处理编码逻辑
• Credentials.basic()方法已经对Basic认证的编码规则做了封装，不需要手动拼接Base64字符串

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