You need to enable JavaScript to run this app. 使用fetch请求OpenWeatherMap接口出现Unexpected token <的JSON解析报错
优惠活动
大模型
产品
解决方案
定价
更多

使用fetch请求OpenWeatherMap接口出现Unexpected token <的JSON解析报错

报错核心本质

抛出SyntaxError: Unexpected token < in JSON at position 0的根本原因非常明确:代码调用response.json()解析响应体时,收到的内容根本不是合法JSON,而是以<字符开头的文本(绝大多数场景下是HTML类页面内容)。JSON解析器遇到不属于合法JSON语法的<字符,就会直接中断解析抛出该异常。

对应你代码场景的具体触发原因
  • 最直接的触发问题(在你当前代码中是必然出现的):fetch请求的URL缺失HTTP/HTTPS协议前缀。你代码里写的请求地址是无协议的裸域名格式api.openweathermap.org/data/2.5/weather...,浏览器会自动把这类没有协议标识的路径识别为当前前端站点的相对路径,根本不会把请求发送到OpenWeatherMap的远程服务器。举个实际场景:你本地前端项目跑在http://localhost:5173,浏览器实际发起的请求地址会变成http://localhost:5173/api.openweathermap.org/data/2.5/weather...,你本地服务没有配置匹配这个路径的接口,最终返回的就是前端项目默认的index.html入口文件,文件开头就是<!DOCTYPE html>,第一个字符就是<,完全匹配这个报错的触发特征。
  • 补全URL后的常见触发场景:就算你给请求地址补上了https://协议头,只要请求没有拿到预期的JSON格式响应,依然会触发这个报错。常见情况包括:CORS跨域规则拦截、API密钥无效、城市参数没有做URI编码导致接口返回HTML格式的错误提示、接口服务临时返回5xx状态的HTML错误页,这些场景下的响应体都是以<开头的HTML内容,不属于合法JSON结构。
  • 代码逻辑的共性缺陷:fetch API的特性和XHR不同——只要网络请求完成,不管返回的是404、500还是其他非2xx状态,都不会自动抛出异常进入catch分支。你在代码中没有校验响应的ok属性,不管服务端返回了什么格式的内容,都直接调用response.json()强行解析,只要遇到非JSON格式的响应体就会触发这个错误。
快速定位问题的方法

打开浏览器开发者工具的Network面板,找到这个请求,两个信息就能100%定位问题:

  1. 查看请求的实际Request URL,确认是不是真的指向OpenWeatherMap的远程域名,还是被错误解析成了当前站点的相对路径
  2. 查看响应体的原始内容,确认是不是以<开头的HTML文本

内容的提问来源于stack exchange,提问作者Bartek

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.14 14:06:03