\":{\"message\":\"invalid character '\\u003c' looking for beginning of value (re...

🔍 报错信息分析

1. 🌐 错误翻译

原文：invalid character '<' looking for beginning of value (request id: 20260818043500519968079c14228f5iMOHcsWi)
译文：在寻找值的起始位置时遇到无效字符 '<'（请求 ID：20260818043500519968079c14228f5iMOHcsWi）

2. 🎯 原因分析

根本原因：解析器期望读取一个合法的值（如 JSON 数据），但实际接收到的响应以 < 开头，这通常是 HTML 文档的起始字符。

错误位置和上下文：

发生在 API 响应体解析阶段，代码尝试解析响应内容为 JSON 或其他结构化数据。

实际收到的响应是 HTML 页面（如错误页、登录页、404 页面等），而非预期的 JSON 数据。

< 是 HTML 标签的起始符号，破坏了解析器对数据格式的预设。

3. 💡 解决方案

修复步骤：

查看完整响应内容：先获取完整的响应体，确认实际返回的是 HTML（而非 JSON）。

检查接口请求配置：

- 确认请求的 API 地址是否正确。
- 检查请求头（尤其是 Content-Type 和 Accept），确保符合接口要求（如设置为 application/json）。

处理非 JSON 响应：

- 先判断响应状态码和内容类型，若为非 JSON 格式，进行相应错误处理。
- 若接口需要登录，检查认证信息（如 token）是否有效或过期。

示例代码（Go 语言处理请求响应）：

import (
	"io"
	"net/http"
	"strings"
)

func safeFetchAPI(url string) error {
	resp, err := http.Get(url)
	if err != nil {
		return err
	}
	defer resp.Body.Close()

	// 读取响应体
	body, err := io.ReadAll(resp.Body)
	if err != nil {
		return err
	}

	// 判断响应是否为 HTML（以 < 开头）
	if strings.TrimSpace(string(body)).HasPrefix("<") {
		// 处理 HTML 响应（如接口返回错误页）
		return fmt.Errorf("接口返回非预期内容，可能为错误页，响应内容：%s", string(body))
	}

	// 若为 JSON，正常解析
	// ... 后续 JSON 解析逻辑
	return nil
}

4. 🛡️ 预防措施

严格校验响应格式：解析前先检查响应的 Content-Type，确认是否符合预期格式（如 application/json），避免直接解析非目标格式的数据。

增加错误处理与日志：捕获响应解析异常时，打印完整响应体、状态码和响应头，便于快速定位接口返回问题（如接口未授权、服务端故障）。

使用工具验证接口：借助 Postman、curl 等工具直接测试接口，确认接口返回格式正确后再集成到代码中，避免因接口本身问题导致解析错误。