OpenStreetMap地理编码API在iOS正常但Android异常问题求助

问题现象 #

调用Nominatim地理编码API时，iOS端正常返回结构化JSON数组，但Android端返回未解析的Response对象（包含_bodyBlob、status等属性），无法直接提取地址数据。

核心问题分析 #

结合代码和返回日志，两个关键问题可能导致Android端异常：

• 请求头格式错误：原代码将User-Agent直接写在请求配置根节点，而非headers对象内，不符合Fetch API规范。Nominatim要求必须设置合法User-Agent，Android端Fetch实现对规范更严格，可能因此导致响应处理异常；iOS端则可能兼容了错误写法。
• 错误处理逻辑不当：原代码在catch块中直接返回错误对象，而非抛出错误，会导致调用方无法区分正常响应与错误，可能误将错误对象当作有效数据处理。

解决方案 #

1. 修正请求头格式 #

将User-Agent移至headers对象内，同时添加Accept头明确指定接收JSON格式：

getGeoCodePosition(lat,lng){
    let apiuri = apiUrl.osm+`&q=${lat},${lng}`;
    console.log(apiuri)
    const requestOptions = {
        method: 'GET',    
        headers: {
            'User-Agent': 'Appname/1.0',
            'Accept': 'application/json'
        }
    };
    return fetch(`${apiuri}`, requestOptions).then((response) => {
        console.log(response)
        if (!response.ok) {
            throw new Error(`HTTP status: ${response.status}`);
        }
        return response.json()
    }).catch((e) => {
        console.error(e)
        throw e; // 抛出错误，交由调用方的catch处理
    })
}

2. 替换解析方式排查兼容性问题 #

若修正请求头后仍异常，改用response.text()先获取原始文本再手动解析JSON，排查Android端response.json()的兼容性问题：

return fetch(`${apiuri}`, requestOptions).then((response) => {
    console.log(response)
    if (!response.ok) {
        throw new Error(`HTTP status: ${response.status}`);
    }
    return response.text().then(rawText => {
        console.log("Raw response:", rawText); // 打印原始响应文本，确认是否为有效JSON
        return JSON.parse(rawText);
    });
}).catch((e) => {
    console.error(e)
    throw e;
})

3. 修正函数参数不匹配问题 #

调用getGeoCodePosition时传入了第三个参数{ language: 'en' }，但函数定义仅接收lat和lng两个参数，导致语言参数未被处理。若需动态设置语言，修改函数定义：

getGeoCodePosition(lat,lng, options = {}){
    const language = options.language || 'en';
    let apiuri = apiUrl.osm+`&q=${lat},${lng}&accept-language=${language}`;
    // 后续请求逻辑不变
}

验证步骤 #

1. 修正代码后在Android端重新测试，查看日志是否输出结构化JSON数组
2. 若仍异常，检查Raw response日志，确认服务器返回的是否为有效JSON
3. 对比Android和iOS端的请求URL、请求头是否完全一致

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