LinkedIn API URL编码问题的解决方案

linkedin v1 api对括号等特殊字符的url编码处理存在兼容性缺陷，直接使用标准库自动编码会导致404错误；通过手动设置`url.url.opaque`字段可绕过自动编码，确保请求路径原样发送。

在使用 go 标准库调用 LinkedIn v1 rest api 时，一个常见但易被忽视的问题是：API 要求字段选择器语法 ~:(id,first-name,last-name) 中的括号 ( 和 ) 必须以未编码的原始形式出现在 URL 路径中，而 Go 的 http.NewRequest 会自动对整个 URL 字符串（包括路径中的括号）进行严格 URL 编码（即转为 %28 和 %29），导致 LinkedIn 服务端无法识别该字段选择器，返回 [invalid.Property.name] 错误。

根本原因在于 LinkedIn v1 API 的解析器未正确处理已编码的括号——它期望接收 ~:(…)，而非 ~:%28…%29，即使后者在 RFC 规范中完全合法。

✅ 正确解法是绕过标准库的自动路径编码逻辑，利用 net/url.URL 类型的 Opaque 字段：该字段若非空，将完全替代 Scheme + Host + Path 的默认拼接行为，且不会被二次编码。

以下是推荐的实现方式：

import (     "net/http"     "net/url" )  // 构造基础 URL（不含路径） u, err := url.Parse("https://api.linkedin.com") if err != nil {     // 处理解析错误 }  // 创建请求，仅传入基础 URL r, err := http.NewRequest("GET", u.String(), nil) if err != nil {     // 处理请求创建错误 }  // 关键：手动设置 Opaque 字段为完整路径（含原始括号） r.URL.Opaque = "/v1/people/~:(id,first-name,last-name)"  // 设置认证头 r.Header.Set("Authorization", "Bearer "+respBody.accessToken)  // 发起请求 resp, err := http.DefaultClient.Do(r) if err != nil {     // 处理请求错误 }

⚠️ 注意事项：

• Opaque 字段必须以 / 开头（表示绝对路径），否则可能引发协议解析异常；
• 此方法仅适用于路径部分含特殊字符（如 (、)、{、} 等）且目标 API 不支持标准编码的场景，不建议滥用；
• LinkedIn v1 API 已于 2023 年正式弃用，生产环境应尽快迁移到 LinkedIn Marketing Developer Platform 或 Ads API v2，其采用标准 OAuth 2.0 + jsON/REST 设计，全面支持规范化的 URL 编码；
• 若必须维持 v1 调用，建议将此逻辑封装为工具函数，避免重复出错。

该方案无需修改 Go 标准库、不引入第三方依赖，符合最小侵入原则，是 Go 生态中应对此类“非标准 API”的典型实践。