根本原因是RSS源采用atom格式或带命名空间xml，且默认未启用扩展解析；需显式设置UserAgent、检查Content-Type、禁用重定向并规范请求头。
用 gofeed 解析 RSS XML 时为什么总返回空项？
多数人第一次用 gofeed 解析 RSS 都会遇到 Feed.Items 为空，但 http 状态码是 200。根本原因不是网络问题，而是 RSS 源用了 Atom 格式、或带命名空间的 XML（比如 content:encoded），而默认配置没启用扩展解析。
- 必须显式启用
gofeed.DefaultClient的UserAgent，否则部分站点（如 Medium、Hacker News RSS）直接拒绝请求 - 调用
parser.ParseURL前，设parser.Client = gofeed.NewClient()，再给Client.UserAgent赋一个真实浏览器 UA 字符串 - 若仍为空，改用
parser.Parse+http.Get手动获取响应体，并检查resp.Header.Get("Content-Type")是否含xml或rss；有些源实际返回 html 登录页
goquery 抓取网页内容做 RSS 补充时如何绕过反爬？
当目标网站不提供 RSS，只能靠解析 HTML 列表页时，goquery 很容易被识别为爬虫。这不是 selector 写得不对，而是请求头和行为缺失。
- 必须设置
http.Client.Timeout（建议 10s），避免卡死；同时禁用重定向（CheckRedirect: func(req *http.Request, via []*http.Request) Error { return http.ErrUseLastResponse }），防止跳转到登录页 - Header 至少包含：
"User-Agent"（用 chrome 最新 UA）、"Accept"（"text/html,application/xhtml+xml"）、"Accept-Language"（"zh-CN,zh;q=0.9"） - 不要高频请求：在循环抓取前加
time.Sleep(1 * time.Second)；若需并发，用semaphore控制最大 3–5 路并发
用 gin 暴露 RSS 数据接口时，jsON 输出中文乱码怎么办？
Go 默认 json 编码器对非 ASCII 字符做 Unicode 转义（如 "u4f60u597d"），前端展示为方块或问号。这不是字体问题，是 HTTP 响应头和编码方式没对齐。
- 必须在
gin.Context.JSON之前，手动写 Header：c.Header("Content-Type", "application/json; charset=utf-8") - 不要用
c.Data直接写字节 ——json.Marshal返回的是 UTF-8 字节，但 gin 默认用bytes.ReplaceAll做二次转义，导致重复编码 - 更稳妥做法：用
c.Render+ 自定义render.JSON，传入json.Encoder并调用SetEscapeHTML(false)，避免把转成u003c
func rssHandler(c *gin.Context) { feed, _ := parseRSS(c.Param("url")) c.Header("Content-Type", "application/json; charset=utf-8") enc := json.NewEncoder(c.Writer) enc.SetEscapeHTML(false) enc.Encode(feed) }本地存储 RSS 条目用 bolt 还是 sqlite？
小规模阅读器（bolt 和 sqlite 之间，选错会导致查询卡顿或无法去重。
立即学习“go语言免费学习笔记（深入）”；
-
bolt是纯 KV，没有 SQL 查询能力 —— 想按时间范围查、按已读状态过滤，就得全量遍历bucket.ForEach，1000 条就明显延迟 -
sqlite更合适：用mattn/go-sqlite3，建表时把link设为UNIQUE，插入前用INSERT OR IGNORE避免重复；查未读条目只需WHERE read = 0 ORDER BY pub_date DESC LIMIT 20 - 注意：SQLite 文件路径别写相对路径（如
"./data.db"），启动时用os.Executable定位程序目录，否则 daemon 模式下工作目录可能不是你预期的位置
真正卡住人的从来不是“怎么解析 RSS”，而是源站返回格式不一致、HTTP 头被拦截、JSON 输出被双重转义、以及本地存取时误判数据规模。这些点不提前踩一遍，调试时花的时间远超写逻辑本身。