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 的默认拼接行为，且不会被二次编码。
Web Accessibility (WCAG 2 AA))
下载
将 WCAG 2 AA 无障碍标准应用于设计系统、UI 组件和网页——通过可运行的验证器进行对比度计算，采用设计 token 模式使颜色天生可访问，设定排版和焦点状态规则，并提供语义检查清单。适用于构建或审查 UI。
以下是推荐的实现方式：
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”的典型实践。
