Question 1

如何修复 your_spotify 无法同步播放数据或导入播放历史记录的问题（Spotify /v1/tracks?ids 接口出现 403 ERR_BAD_REQUEST 错误）？

Accepted Answer

此错误发生在旧版本的 your_spotify 中，这些版本依赖 Spotify 已弃用的批量曲目端点 `GET /v1/tracks?ids=<comma-separated-track-ids>`，该端点现在返回 403 Forbidden（对 `/v1/tracks/{id}` 的单曲目请求仍可正常工作）。它会阻断所有同步和导入功能，日志中会反复出现 `Retrying crashed promise` 消息，随后是 `ERR_BAD_REQUEST`。常见的排查步骤，例如重新创建 Spotify 应用、轮换 OAuth 令牌、重新安装 MongoDB 或清除 Cookie，都无法解决根本原因。修复方法：将您的 your_spotify 实例升级到最新官方版本，该版本已迁移、不再使用这个已弃用的端点。对于 linuxserver.io 的 Docker 部署，请等待最新镜像构建完成，然后运行 `docker pull linuxserver/your_spotify:latest` 并重新创建容器。

Question 2

为什么 Spotify Full Privacy 导入播客和有声读物条目时会失败，并显示“expected string, received null”错误？

Accepted Answer

导入验证期望非空的'master_metadata_track_name'和'spotify_track_uri'，但Spotify的扩展流媒体历史导出包含这些字段为null的播客/有声书条目。作为替代方案，请预处理您的文件以过滤掉这些记录：

python
import json
with open('Streaming_History_Audio_2024-2025_0.json') as f:
    data = json.load(f)
cleaned = [r for r in data if r.get('master_metadata_track_name') is not None]
with open('cleaned.json', 'w') as f:
    json.dump(cleaned, f)

然后导入'cleaned.json'。或者，升级到Your Spotify v1.18.0或更高版本，其中可能包含修复。

Question 3

如何修复导入 Spotify 历史记录后出现的 Your Spotify 错误 'Cannot read properties of null (reading full_artists)'？

Accepted Answer

崩溃的原因是某条导入的听歌历史记录项中 `track: null`，而 History 组件在未做空值检查的情况下读取了 `track.full_artists`。临时解决方法：播放几首新歌，使这条格式异常的历史记录项移出初始渲染的 History 区域；用户反馈这样操作后主页即可正常加载。要彻底修复，请在 `apps/client/src/components/History/History.tsx` 中渲染之前过滤掉无效项，例如 `items.filter(item => item.track != null).map(...)`，并使用可选链访问，如 `item.track?.full_artists` 和 `item.track?.full_album`，然后重新构建客户端。另外，也可以在 DevTools 中检查历史记录 API 的响应，找到 `"track": null` 的条目，然后删除或更正该条导入的记录。

Question 4

为什么服务器在请求 Spotify tracks API 时会收到 403 Forbidden 错误？

Accepted Answer

403错误表明存在身份验证或授权问题，通常是由于访问令牌无效或权限范围不足所致。此特定问题已在后续服务器版本中得到修复。请更新至可用的最新版本。若更新后问题仍然存在，请仔细检查您的Spotify应用凭据和所需权限，然后提交新的问题以获取进一步帮助。

Question 5

为什么登录后主页会变成空白并显示"You need to enable JavaScript"，即使JavaScript已启用？

Accepted Answer

空白页是由于 SPA 在渲染 `/api/spotify/gethistory` 的响应时崩溃导致的；JavaScript 提示信息只是应用的兜底（fallback）内容。200 响应仍可能包含触发客户端渲染错误的数据。

临时解决方法：
1. 按 `F12` 打开 Firefox DevTools，切换到 **Network**（网络）面板。
2. 找到匹配 `/api/spotify/gethistory*` 的请求。
3. 右键点击该请求，选择 **Block URL**（或将该 URL 添加到请求拦截列表）。
4. 刷新主页。

页面应保持可见，尽管历史记录部分会一直显示加载中。请检查/清理 `gethistory` 返回的 JSON，尤其是最近同步的 Spotify 历史记录条目，以找出导致崩溃的格式错误或异常记录。

YourSpotify

核心功能

避坑指南

适用场景

标签

快速上手

相似推荐