Eclipse中Java Maven项目HTTP请求正常，打包为Jar后遭Cloudflare 403拦截问题求助

这个问题我之前也碰到过，Cloudflare返回的1010错误本质是它把你的Jar程序发起的请求识别成了可疑机器人，而本地Eclipse运行时的请求特征刚好躲过了检测。下面是具体的排查和解决方案：

1. 优先添加合规的User-Agent请求头 #

Discord的API文档明确要求所有请求必须包含能识别你应用的User-Agent（格式建议为应用名称/版本 (联系方式)），Java程序默认的User-Agent是类似Java/1.8.0_XXX，这种极易被Cloudflare的Bot检测规则拦截。

你只需要在创建请求时添加这个头即可：

try {
    final HttpRequest rq = new HttpRequest("https://discord.com/api/v8/guilds/"+this.serverID+"/channels", "utf-8", "GET");
    rq.addHeader("Content-Type", "application/json");
    rq.addHeader("Authorization", "Bot " + this.token);
    // 添加合规的User-Agent
    rq.addHeader("User-Agent", "MyDiscordBot/1.0.0 (your.email@example.com)");
    rq.setPostData(null);
    res = rq.finish();
    System.out.println(res);
} catch (Exception e) {
    e.printStackTrace();
}

本地Eclipse运行时，可能因为IDE的环境或JVM的隐式配置，请求的UA被修改成了更“友好”的内容，而Jar独立运行时用了原始的Java UA，这才导致了差异。

2. 检查Maven打包配置 #

确保Maven打包过程没有对HttpRequest类做破坏性处理：

• 如果使用maven-shade-plugin打包，确认配置中没有遗漏或混淆HTTP相关的类；
• 保证打包后的Jar使用的JDK版本和本地Eclipse运行的版本一致，不同版本的HttpURLConnection可能存在细微的行为差异。

3. 改用官方推荐的Discord Java库 #

手写HTTP客户端很容易踩各种API规范和反爬的坑，Discord官方推荐的Java库（比如JDA或Discord4J）已经封装了所有细节：包括Cloudflare验证处理、速率限制、请求重试等，可靠性远高于自定义的HTTP类。

比如用JDA获取服务器频道的代码只需要：

// 初始化JDA实例后
Guild guild = jda.getGuildById(serverID);
List<TextChannel> channels = guild.getTextChannels();
// 处理频道数据

4. 验证请求特征差异 #

你可以用curl工具模拟Jar运行时的请求头，确认是否是UA导致的问题：

# 模拟Java默认UA的请求
curl -H "Authorization: Bot YOUR_BOT_TOKEN" -H "User-Agent: Java/1.8.0_301" https://discord.com/api/v8/guilds/YOUR_SERVER_ID/channels

如果返回403，那就能100%确认是UA的问题，添加合规的UA后即可解决。

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