网站收藏夹功能开发的核心，是为登录用户提供网站收藏、分类管理、查询和删除能力，并通过清晰的接口契约保证前端、后端与数据库对字段含义保持一致。适合先确定数据模型和请求规则，再实现页面交互，避免只完成“收藏按钮”而缺少列表、去重、权限和异常处理。

一、先确定收藏夹的功能边界

基础版本可以围绕一条完整链路设计：用户提交网站地址，系统保存收藏记录，用户在收藏列表中查看、搜索、修改或删除记录。分类需求较明确时，再增加收藏夹目录；不建议在第一版同时加入复杂的分享、协作、推荐和网页内容抓取。

• 新增收藏：保存网址、标题、备注和所属收藏夹。
• 收藏列表：按当前用户返回记录，支持分页、分类筛选和关键词查询。
• 编辑收藏：修改标题、备注或所属收藏夹。
• 删除收藏：删除指定记录，删除后不再出现在普通列表中。
• 收藏夹管理：新建、重命名和删除分类；删除分类时，分类下的网站保留，但其 folder_id 置为空。

如果产品只需要个人收藏，数据权限应以用户为边界。一个用户只能读取和修改自己的记录，不能仅凭修改 URL 中的收藏 ID 访问其他用户的数据。

二、推荐的数据结构与参数含义

以下是一套适合个人网站收藏夹的基础模型。它是自行开发时可以采用的接口设计，不代表某个已有平台自动提供这些接口。

收藏夹目录至少需要 id、user_id、name、created_at 和 updated_at。如果产品没有多级目录需求，建议暂时不增加 parent_id，平面分类更容易维护，也能减少删除和移动目录时的边界问题。

三、接口契约应先于页面实现确定

采用 REST 风格时，可以使用以下路径作为网站收藏夹的基础接口。路径前缀、鉴权方式和字段命名可以根据项目规范调整，但请求参数、返回结果和状态码应保持稳定。

1. 新增收藏

POST /api/v1/favorites

请求体至少包含 url，可包含 title、folder_id 和 note。服务端校验网址格式、字段长度以及收藏夹是否属于当前用户，成功后返回新记录的完整字段，状态码使用 201。

若系统规定同一用户不能重复收藏同一个网址，应在数据库中建立用户与规范化网址的唯一约束。重复提交时返回 409，而不是静默创建多条相同记录。若产品允许同一网站保存多个不同备注，则不能使用这一唯一规则，需要改为允许重复并明确列表展示方式。

2. 获取收藏列表

GET /api/v1/favorites

建议支持以下查询参数：

• folder_id：按收藏夹筛选。
• keyword：匹配标题、网址或备注；没有搜索需求时可以暂不实现。
• limit：每页条数，服务端应设置上限，避免一次返回过多数据。
• cursor：分页游标；数据量较小时也可以使用 page 和 page_size。

返回结果应包含记录数组和分页信息，例如 items、next_cursor 和 has_more。默认排序应固定为创建时间倒序或更新时间倒序，不能依赖数据库未声明的自然顺序。列表接口必须根据当前登录用户过滤 user_id，不能让前端传入用户 ID 来决定数据范围。

3. 查看、修改和删除单条收藏

GET /api/v1/favorites/{id} 用于获取详情；PATCH /api/v1/favorites/{id} 用于部分更新；DELETE /api/v1/favorites/{id} 用于删除。修改请求可以只提交需要变化的字段，未提交字段保持原值。删除成功返回 204，再次删除已不存在的记录时，应统一约定返回 404 或幂等返回 204，前后端不能各自采用不同规则。

当更新 folder_id 时，服务端必须检查目标收藏夹的归属。前端隐藏了其他用户的目录，不等于后端已经完成权限校验。

4. 收藏夹目录接口

目录接口可以设计为 POST /api/v1/folders、GET /api/v1/folders、PATCH /api/v1/folders/{id} 和 DELETE /api/v1/folders/{id}。目录名称不能为空，并限制长度；同一用户是否允许重名应在产品规则中确定。删除目录时，推荐保留收藏记录并将 folder_id 设为空，避免用户误删网站。

四、实现时最容易出错的参数规则

网址校验不能只判断字符串是否以“www”开头。后端至少应检查协议、主机名和长度，拒绝明显无效的值。保存前可以去除首尾空格，并生成用于去重的 normalized_url。规范化应保持保守，例如不要随意删除查询参数，因为查询参数可能决定页面内容；是否忽略网址片段、默认端口或末尾斜杠，也应形成固定规则并写入测试。

标题和备注应限制最大字符数，防止超长输入影响数据库和列表布局。接口返回给 HTML 页面时，用户输入内容必须经过前端或模板层的安全转义，不能把标题、备注直接拼接为可执行标记。若系统需要自动读取网页标题，应将其作为可选的异步能力，自动读取失败不能阻断用户手动保存网址。

鉴权失败返回 401，已登录但无权访问返回 403，参数错误返回 400，目标不存在返回 404。这些状态码应在接口文档和前端提示中保持一致，不能全部转换成含义不明的成功响应。

五、前后端联调与验收重点

前端点击收藏后，应根据接口返回结果更新列表，而不是仅在本地假设保存成功。请求期间需要防止重复提交；接口返回 409 时，可以提示“该网址已收藏”，并提供进入已有记录的入口。列表为空、网络失败、分页结束和分类删除后的未分类状态，都应有明确的界面反馈。

• 未登录用户不能创建或读取个人收藏。
• 缺少网址、协议错误和超长字段会被服务端拒绝。
• 用户 A 不能通过修改收藏 ID 读取或修改用户 B 的记录。
• 重复收藏的处理结果符合既定规则。
• 删除收藏夹不会意外删除其中的网站记录。
• 分页、关键词查询和分类筛选组合使用时，结果范围保持正确。

六、适用条件与后续扩展

上述方案适合个人账户、数量中等、以保存网址为主的网站收藏夹。若需求扩大到团队共享、公开收藏、标签体系、跨设备同步或导入浏览器书签，应新增可见范围、成员权限、标签关系和批量导入格式，不能仅在现有收藏表上增加一个“公开”字段就视为完成。第一版先把用户归属、字段校验、列表查询和删除行为做成稳定契约，后续扩展会更容易控制兼容性。