HttpUtil.post调用getwxacodeunlimit无返回？

Question

使用 `HttpUtil.post` 调用微信接口 `getwxacodeunlimit` 时无返回，常见于请求参数格式错误或未正确设置请求头。该接口要求以 POST 方式发送 JSON 数据，并携带有效的 access_token。若未设置 `Content-Type: application/json`，或入参 scene 字符串过长、包含非法字符，会导致微信服务器无响应或返回空结果。同时，网络层超时配置不当也可能误判为“无返回”。需检查请求体序列化、SSL 证书信任及响应流读取逻辑，确保完整接收二进制二维码数据。

Answer 1

1. 问题背景与接口调用基本要求

微信小程序的 getwxacodeunlimit 接口用于生成带参数的小程序码，支持通过 scene 字段传递自定义参数。该接口必须使用 POST 方法调用，且请求体为 JSON 格式，Content-Type 需设置为 application/json。

常见错误包括未携带有效的 access_token、scene 参数非法（如长度超过32字符或包含特殊符号）、未正确序列化请求体等。这些都可能导致接口无返回或返回空数据流。

此外，由于该接口返回的是二进制图像数据（PNG格式），若客户端未正确处理响应流，也可能误判为“无返回”。

2. 常见问题分类分析

• 请求头缺失 Content-Type：未设置 Content-Type: application/json 导致微信服务器无法解析请求体。
• access_token 无效或过期：token 获取失败、缓存策略不当或未刷新导致认证失败。
• scene 参数不合规：长度超过32字节、包含中文或特殊字符（如 #、%）而未进行编码校验。
• JSON 序列化错误：对象字段命名不符合微信规范（如应为小写），或嵌套结构错误。
• SSL/TLS 证书信任问题：JVM 不信任微信 API 的 HTTPS 证书链，导致连接中断。
• 网络超时配置不合理：读取超时太短，未能接收完整的二维码二进制流。
• 响应流未正确读取：未以二进制方式读取 InputStream，或提前关闭流。

3. 调用流程与关键检查点

POST https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=ACCESS_TOKEN
Content-Type: application/json

{
  "scene": "user_12345",
  "page": "pages/index/index",
  "width": 430,
  "auto_color": false,
  "line_color": { "r": 0, "g": 0, "b": 0 }
}
    

上述是标准请求示例。以下是调用过程中的关键检查点：

阶段	检查项	建议值/说明
请求前	access_token有效性	确保已缓存并定期刷新
构造请求	Content-Type	必须为 application/json
	scene长度	≤32字节，避免中文和特殊字符
发送请求	HTTP方法	必须为POST
接收响应	响应类型判断	先检查是否为JSON错误，再按二进制处理
流处理	InputStream读取	使用BufferedInputStream完整读取

4. 典型代码实现与调试建议

String url = "https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=" + token;
Map param = new HashMap<>();
param.put("scene", "test123");
param.put("page", "pages/home/home");

// 确保使用正确的JSON序列化工具
String jsonBody = JSON.toJSONString(param);

HttpUtil.post(url, jsonBody); // 注意：需确保底层设置了Content-Type
    

在实际开发中，建议对 HttpUtil.post 方法做如下增强：

1. 显式设置请求头：Connection: close 和 Content-Type: application/json;charset=UTF-8
2. 启用详细日志输出，记录请求URL、header、body及响应状态码
3. 捕获异常并区分连接超时、读取超时、SSL握手失败等情况
4. 对接口返回内容先尝试解析为JSON（判断是否出错），否则作为图片流保存

5. 网络层与安全配置深度剖析

Java应用常因默认 SSL 上下文不信任公网 CA 而导致 HTTPS 请求失败。可通过以下方式验证：

// 使用OkHttpClient示例
OkHttpClient client = new OkHttpClient.Builder()
    .connectTimeout(10, TimeUnit.SECONDS)
    .readTimeout(30, TimeUnit.SECONDS) // 必须足够长以接收图片
    .build();
    

若使用自封装 HttpUtil，需确认其底层是否忽略证书验证或正确加载 TrustManager。生产环境不应跳过证书校验，但测试阶段可临时启用宽松模式辅助排查。

6. 完整调用流程图（Mermaid）

graph TD
    A[开始] --> B{获取access_token}
    B -- 成功 --> C[构建scene参数]
    B -- 失败 --> M[记录日志并退出]
    C --> D{校验scene长度≤32且合法}
    D -- 合法 --> E[构造JSON请求体]
    D -- 非法 --> M
    E --> F[设置Header: Content-Type=application/json]
    F --> G[发送POST请求]
    G --> H{响应状态码==200?}
    H -- 是 --> I{响应是否为JSON错误?}
    I -- 是 --> J[解析错误信息]
    I -- 否 --> K[读取二进制流保存为PNG]
    H -- 否 --> L[记录HTTP错误]
    J --> N[结束]
    K --> N
    L --> N
    M --> N