Java 实现百度地图 SN 权限签名：搜索 2.0 接口实战

二、在 Java 中的应用

1、请求 Map 参数化

首先定义数据请求参数 Map，这是生成签名的基础。注意参数顺序需与最终 URL 一致。

Map<String, String> params = new LinkedHashMap<String, String>();
String query = "邮政";
String region = "158";
String scope = "2";
String output = "json";
String ret_coordtype = "WGS84";
int pageSize = 20;
int pageNum = 0;
params.put("query", query);
params.put("region", region);
params.put("output", output);
params.put("scope", scope);
params.put("ret_coordtype", ret_coordtype);
params.put("page_size", String.valueOf(pageSize));
params.put("page_num", String.valueOf(pageNum));
params.put("ak", AK);

2、SN 签名生成

生成签名前，需对 Map 内的所有 value 进行 UTF-8 编码并拼接成字符串。这里推荐使用 Spring 的 UriUtils 或 JDK 自带的 URLEncoder。

// 对 Map 内所有 value 作 utf8 编码，拼接返回结果
public String toQueryString(Map<?, ?> data) throws UnsupportedEncodingException {
    StringBuffer queryString = new StringBuffer();
    for (Map.Entry<?, ?> pair : data.entrySet()) {
        queryString.append(pair.getKey() + "=");
        // 使用 UriUtils 处理中文转义
        queryString.append(UriUtils.encode((String) pair.getValue(), "UTF-8") + "&");
    }
    if (queryString.length() > 0) {
        queryString.deleteCharAt(queryString.length() - 1);
    }
    return queryString.toString();
}

接着拼接接口前缀和 SK 值，例如 /place/v2/search?paramsStr+SK，再次进行 UTF-8 编码。

// 拼接完整字符串
String wholeStr = new String("/place/v2/search?" + paramsStr + SK);
System.out.println(wholeStr);
// 二次编码
String tempStr = URLEncoder.encode(wholeStr, "UTF-8");

最后调用 MD5 方法生成 SN 值。

// 调用 MD5 方法得到最后的 sn 签名
String sn = snCal.MD5(tempStr);
System.out.println("sn===>" + sn);

MD5 实现参考如下：

public String MD5(String md5) {
    try {
        java.security.MessageDigest md = java.security.MessageDigest.getInstance("MD5");
        byte[] array = md.digest(md5.getBytes());
        StringBuffer sb = new StringBuffer();
        for (int i = 0; i < array.length; ++i) {
            sb.append(Integer.toHexString((array[i] & 0xFF) | 0x100).substring(1, 3));
        }
        return sb.toString();
    } catch (java.security.NoSuchAlgorithmException e) {
    }
    return null;
}

3、搜索接口调用

使用原生 Java 对象发送网络请求。核心流程是构建 URL、建立连接、读取流。

public void requestGetSN(String strUrl, Map<String, String> param) throws Exception {
    if (strUrl == null || strUrl.length() <= 0 || param == null || param.size() <= 0) {
        return;
    }
    StringBuffer queryString = new StringBuffer();
    queryString.append(strUrl);
    for (Map.Entry<?, ?> pair : param.entrySet()) {
        queryString.append(pair.getKey() + "=");
        queryString.append(UriUtils.encode((String) pair.getValue(), "UTF-8") + "&");
    }
    if (queryString.length() > 0) {
        queryString.deleteCharAt(queryString.length() - 1);
    }
    java.net.URL url = new URL(queryString.toString());
    URLConnection httpConnection = (HttpURLConnection) url.openConnection();
    httpConnection.connect();
    InputStreamReader isr = new InputStreamReader(httpConnection.getInputStream());
    BufferedReader reader = new BufferedReader(isr);
    StringBuffer buffer = new StringBuffer();
    String line;
    while ((line = reader.readLine()) != null) {
        buffer.append(line);
    }
    reader.close();
    isr.close();
    System.out.println("SN: " + buffer.toString());
}

在 Main 方法中组装参数并调用：

package com.yelang.project.unihttp;
import org.springframework.web.util.UriUtils;
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.io.UnsupportedEncodingException;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLConnection;
import java.net.URLEncoder;
import java.security.NoSuchAlgorithmException;
import java.util.LinkedHashMap;
import java.util.Map;

public class SearchHttpSN {
    public static String AK = "yourak";
    public static String SK = "yoursk";
    public static String URL = "https://api.map.baidu.com/place/v2/search?";

    public static void main(String[] args) throws Exception {
        SearchHttpSN snCal = new SearchHttpSN();
        Map<String, String> params = new LinkedHashMap<String, String>();
        String query = "邮政";
        String region = "158";
        String scope = "2";
        String output = "json";
        String ret_coordtype = "WGS84";
        int pageSize = 20;
        int pageNum = 0;

        params.put("query", query);
        params.put("region", region);
        params.put("output", output);
        params.put("scope", scope);
        params.put("ret_coordtype", ret_coordtype);
        params.put("page_size", String.valueOf(pageSize));
        params.put("page_num", String.valueOf(pageNum));
        params.put("ak", AK);
        params.put("sn", snCal.caculateSn());

        snCal.requestGetSN(URL, params);
    }
}

执行成功后，控制台将输出包含数据的 JSON 响应，表明 SN 验证通过。

三、APP SN 校验失败可能的原因

实际开发中，签名校验失败通常由以下几个细节导致。

1、字符编码问题

API 请求中包含中文或特殊字符时，必须进行 UTF-8 编码。URL 非保留字（如字母数字）无需编码，但中文及特殊符号（如问号、斜杠等）必须转换。如果直接使用未编码的中文字符，后台解析会乱码，导致签名不匹配。

2、参数顺序

SN 算法严格依赖参数顺序。GET 请求使用 LinkedHashMap 保持插入顺序，任何调整都会改变最终的 MD5 值。例如，随意交换 query 和 region 的位置，生成的 SN 就会不同，服务端校验时会返回 status: 211, message: APP SN 校验失败。

3、timestamp 的设置

官方文档要求设置 SN 后 timestamp 必填。但在实测中，部分接口未传递该参数也能正常请求，可能是内部容错机制。不过为了规范起见，建议仍遵循文档要求添加该字段。

四、总结

本文梳理了 Java 环境下百度地图 SN 权限签名的完整实践流程。从申请应用、获取 SK，到参数排序、编码拼接及 MD5 加密，每一步都直接影响接口调用的成功率。重点排查了字符编码、参数顺序等常见坑点，希望能帮助开发者快速解决集成中的安全问题。