https://plumephp.com/posts/saas/shortlink/Recent content in 【专题】短链接服务（Birdor）— 从商业构想到技术落地的完整知识体系 on PlumePHPHugozh-CNThu, 06 Aug 2026 14:00:00 +0800https://plumephp.com/shortlink35-vs-long-url/Thu, 06 Aug 2026 11:00:00 +0800https://plumephp.com/shortlink35-vs-long-url/从可读性、信任度、SEO、平台限制等8个维度全面对比短链与长链，附使用决策树助你做出正确选择。https://plumephp.com/shortlink36-self-hosted/Thu, 06 Aug 2026 12:00:00 +0800https://plumephp.com/shortlink36-self-hosted/Shlink、YOURLS、Polr、Supabase+自研四种自托管短链方案横向对比，含Docker一键部署、数据迁移、成本分析。https://plumephp.com/shortlink37-expiration-recovery/Thu, 06 Aug 2026 13:00:00 +0800https://plumephp.com/shortlink37-expiration-recovery/短链失效问题深度解析：软删除机制、过期续期策略、归档方案、用户通知与短码回收的完整工程实践，附Go实现代码。https://plumephp.com/shortlink38-api-first/Thu, 06 Aug 2026 14:00:00 +0800https://plumephp.com/shortlink38-api-first/API优先的短链服务设计完整指南：RESTful API规范、多语言SDK架构、Webhook事件体系、GraphQL扩展、速率限制策略，以及打造顶级开发者体验(DX)的实战经验。https://plumephp.com/shortlink22-seo/Thu, 06 Aug 2026 10:00:00 +0800https://plumephp.com/shortlink22-seo/深度解析短链接对 SEO 的影响，覆盖 HTTP 重定向状态码对 PageRank 的传递差异、品牌短链与公共短链的 SEO 对比、Google 索引机制与实战优化建议，帮助 SEO 从业者和营销人员正确使用短链接。https://plumephp.com/shortlink25-utm/Thu, 06 Aug 2026 09:00:00 +0800https://plumephp.com/shortlink25-utm/本文系统讲解 UTM 参数的定义、5 个核心字段详解、命名规范，以及 UTM 与短链接结合的最佳实践。涵盖主流 UTM builder 工具对比、数据分析方法、常见错误规避和高级玩法，帮你建立一套完整的营销追踪工作流。https://plumephp.com/shortlink23-comparison/Thu, 06 Aug 2026 00:00:00 +0800https://plumephp.com/shortlink23-comparison/面向个人博主、电商、企业和开发者的 2025 年最佳短链工具全面对比。深度评测 Bit.ly、TinyURL、Rebrandly、Short.io、百度短链、新浪短链等 7 款主流短链接平台，涵盖价格、自定义域名、数据分析、API、安全性、&hellip;https://plumephp.com/shortlink31-ai-redirect/Thu, 06 Aug 2026 00:00:00 +0800https://plumephp.com/shortlink31-ai-redirect/AI驱动的智能短链接跳转系统深度解析。涵盖用户意图识别、个性化落地页推荐、动态A/B测试引擎、 实时转化率优化，以及可落地的规则引擎与ML模型架构。https://plumephp.com/shortlink26-base62/Thu, 06 Aug 2026 00:00:00 +0800https://plumephp.com/shortlink26-base62/深入解析 Base62 短码生成算法的数学原理，涵盖进制选择依据、编码/解码核心实现、冲突处理策略、性能调优技巧， 以及适用于高并发场景的 Go 语言可运行代码。https://plumephp.com/shortlink29-qr-code/Thu, 06 Aug 2026 00:00:00 +0800https://plumephp.com/shortlink29-qr-code/二维码与短链接整合的完整技术方案。涵盖动态二维码生成、扫描数据追踪、移动端深度链接、 私域引流闭环设计，以及可落地的生成器代码实现。https://plumephp.com/shortlink27-architecture/Thu, 06 Aug 2026 00:00:00 +0800https://plumephp.com/shortlink27-architecture/短链接服务的高并发架构设计指南。涵盖读写 QPS 差距分析、多级缓存策略、数据库分片、 读写分离、CDN 加速、热点短链探测与削峰填谷等核心技术方案。https://plumephp.com/shortlink21-build-guide/Thu, 06 Aug 2026 00:00:00 +0800https://plumephp.com/shortlink21-build-guide/从零构建 URL 短链接系统的完整技术指南。 涵盖 Base62 编码数学推导、发号器方案对比、数据库与缓存设计、高并发读写优化、安全防护策略， 以及可运行的 Go 语言最小实现（Redis + MySQL）。https://plumephp.com/shortlink28-bloom-filter/Thu, 06 Aug 2026 00:00:00 +0800https://plumephp.com/shortlink28-bloom-filter/布隆过滤器在短链接系统中的深度实战。涵盖算法原理、参数调优公式、Redis 模块实现、 去重与防穿透场景、误判率控制策略，以及可落地的 Go 代码示例。https://plumephp.com/shortlink30-security/Thu, 06 Aug 2026 00:00:00 +0800https://plumephp.com/shortlink30-security/短链接服务的安全架构全面指南。涵盖恶意链接检测、访问限流、反钓鱼策略、重定向安全、 数据隐私保护，以及企业级风控体系的设计与实现。https://plumephp.com/shortlink34-martech/Thu, 06 Aug 2026 00:00:00 +0800https://plumephp.com/shortlink34-martech/短链接服务与MarTech生态的深度集成方案。涵盖CRM/CDP对接、广告平台归因、营销自动化工作流、 数据回流闭环，以及UTM智能生成与跨平台用户画像打通。https://plumephp.com/shortlink33-monetization/Thu, 06 Aug 2026 00:00:00 +0800https://plumephp.com/shortlink33-monetization/短链接服务盈利模式的全面拆解。涵盖订阅分层、API计费、企业定制、流量变现、联盟佣金、 数据增值六大收入来源，以及LTV/CAC模型、定价策略与ARPU优化方法论。https://plumephp.com/shortlink32-white-label/Thu, 06 Aug 2026 00:00:00 +0800https://plumephp.com/shortlink32-white-label/短链接白标平台（White Label URL Shortener）完整构建方案。涵盖多租户架构设计、自定义域名接入、 品牌定制体系、API/SDK 对外输出，以及企业级安全与隔离策略。https://plumephp.com/shortlink24-private-domain/Thu, 06 Aug 2026 00:00:00 +0800https://plumephp.com/shortlink24-private-domain/深度解析短链接在微信、抖音、小红书等私域运营场景中的实战策略，涵盖渠道追踪、裂变增长、防封域名、活码技术、转化漏斗优化等核心方法论，帮助 SaaS 企业和品牌商家从引流到转化构建完整的私域增长闭环。https://plumephp.com/shortlink19-future/Thu, 25 Sep 2025 16:28:36 +0800https://plumephp.com/shortlink19-future/<h2 id="一市场趋势">一、市场趋势</h2> <ol> <li> <p><strong>全球互联网流量持续增长</strong></p> <ul> <li>全球网民超过 <strong>50 亿</strong>，每天产生数百亿条链接。</li> <li>链接的分享、追踪和优化成为数字营销与传播的基础设施。</li> </ul> </li> <li> <p><strong>营销数字化 &amp; 精细化运营</strong></p>https://plumephp.com/shortlink18-flywheel/Thu, 25 Sep 2025 15:28:36 +0800https://plumephp.com/shortlink18-flywheel/<h2 id="一阶段性目标">一、阶段性目标</h2> <ol> <li> <p><strong>0–6 个月（启动期 / MVP 验证）</strong></p> <ul> <li>上线基础功能：短链生成、跳转、基础统计、二维码。</li> <li>获取首批用户（目标：1 万+ 注册用户）。</li> <li>打造「轻快、无广告、专业」的口碑，和现有国内工具区隔。</li> </ul> </li> <li> <p><strong>6–12 个月（市场启动 / 用户增长）</strong></p>https://plumephp.com/shortlink17-bmc/Thu, 25 Sep 2025 14:28:36 +0800https://plumephp.com/shortlink17-bmc/<h2 id="1-客户细分customer-segments">1. 客户细分（Customer Segments）</h2> <ul> <li> <p><strong>个人用户</strong></p> <ul> <li>自媒体、博主、营销人员</li> <li>需求：简洁短链 + 基础统计</li> </ul> </li> <li> <p><strong>中小企业</strong></p> <ul> <li>电商、教育、游戏、活动主办方</li> <li>需求：品牌域名、数据统计、二维码</li> </ul> </li> <li> <p><strong>大型企业/机构</strong></p>https://plumephp.com/shortlink16-business-model/Thu, 25 Sep 2025 13:28:36 +0800https://plumephp.com/shortlink16-business-model/<h2 id="一核心商业模式">一、核心商业模式</h2> <p>短网址本质上是一个「流量中转基础设施」，其商业价值来自 <strong>流量入口控制 + 数据洞察 + 企业服务扩展</strong>。</p> <ul> <li><strong>用户价值</strong>：简化分享、增强品牌一致性、获取数据反馈。</li> <li><strong>企业价值</strong>：追踪转化、优化广告 ROI、保障合规安全。</li> <li><strong>我们的定位</strong>：不仅是「短链工具」，而是「链接智能化管理 SaaS 平台」。</li> </ul> <hr> <h2 id="二收入来源revenue-streams">二、收入来源（Revenue Streams）</h2> <h3 id="1-订阅制-saas-收入核心">1. <strong>订阅制 SaaS 收入（核心）</strong></h3> <ul> <li> <p><strong>个人用户（Freemium 模式）</strong></p>https://plumephp.com/shortlink15-todo/Thu, 25 Sep 2025 12:28:36 +0800https://plumephp.com/shortlink15-todo/<h2 id="1-智能跳转smart-redirects">1. <strong>智能跳转（Smart Redirects）</strong></h2> <ul> <li> <p><strong>时间维度</strong>：同一个短链在不同时间段跳转到不同页面。</p> <ul> <li>例：活动前 → 预热页，活动中 → 促销页，活动后 → 总结页。</li> </ul> </li> <li> <p><strong>地域维度</strong>：根据访问者所在国家/地区跳转到本地化页面。</p>https://plumephp.com/shortlink14-site/Thu, 25 Sep 2025 11:28:36 +0800https://plumephp.com/shortlink14-site/<h2 id="1-hero-banner首屏">1. Hero Banner（首屏）</h2> <ul> <li> <p><strong>主标题（H1）：</strong><br> <strong>让链接飞翔</strong></p> </li> <li> <p><strong>副标题（H2）：</strong><br> <strong>Birdor – 轻快、可靠、智能的短网址与二维码服务</strong></p> </li> <li> <p><strong>核心卖点（3 个简短点）：</strong></p>https://plumephp.com/shortlink13-brand/Thu, 25 Sep 2025 10:28:36 +0800https://plumephp.com/shortlink13-brand/<h2 id="起源">起源</h2> <p>在信息爆炸的时代，每天都有无数的链接被分享、点击、转发。<br> 但我们发现，大多数链接——冗长、复杂、不便于传播，也缺乏对数据的追踪能力。</p> <p>我们希望创造一个<strong>像小鸟一样轻盈快速的传递工具</strong>：</p>https://plumephp.com/shortlink12-roadmap-01/Thu, 25 Sep 2025 09:29:36 +0800https://plumephp.com/shortlink12-roadmap-01/<h2 id="阶段一mvp06-个月">阶段一：MVP（0–6 个月）</h2> <p><strong>目标</strong>：验证市场需求，快速上线基础功能</p> <ul> <li> <p>核心功能：</p> <ul> <li>短链生成 &amp; 跳转</li> <li>基础访问统计（PV/UV）</li> <li>短链历史管理</li> <li>短链二维码生成</li> <li>用户注册/登录 + 简单 Dashboard</li> </ul> </li> <li> <p>技术架构：单体服务 + MySQL + Redis 缓存</p>https://plumephp.com/shortlink12-roadmap-00/Thu, 25 Sep 2025 09:28:36 +0800https://plumephp.com/shortlink12-roadmap-00/<h2 id="阶段一mvp0-6个月">阶段一：MVP（0-6个月）</h2> <p><strong>目标</strong>：快速上线，验证产品价值与核心功能。</p> <ul> <li> <p><strong>功能目标</strong>：</p> <ul> <li>短链生成/跳转</li> <li>Dashboard 管理</li> <li>API Key 管理</li> <li>基础统计（PV/UV，按日）</li> </ul> </li> <li> <p><strong>技术实现</strong>：</p> <ul> <li>单节点应用服务</li> <li>MySQL 单实例 + Redis 单实例</li> <li>日志直接写 DB，统计延迟较高</li> </ul> </li> <li> <p><strong>监控运维</strong>：</p>https://plumephp.com/shortlink11-monitor/Wed, 24 Sep 2025 18:28:36 +0800https://plumephp.com/shortlink11-monitor/<h2 id="1-应用层监控">1. 应用层监控</h2> <h3 id="11-短链跳转">1.1 短链跳转</h3> <ul> <li> <p><strong>跳转 QPS</strong></p> <ul> <li>指标：每秒短链访问次数</li> <li>目标：单节点 ≥ 5k QPS</li> <li>告警：超过 80% 峰值 → 告警</li> </ul> </li> <li> <p><strong>跳转延迟（RT）</strong></p> <ul> <li>P50、P95、P99 响应时间</li> <li>目标：P95 ≤ 100ms</li> <li>告警：P95 &gt; 200ms</li> </ul> </li> </ul> <h3 id="12-短链生成">1.2 短链生成</h3> <ul> <li> <p><strong>生成 API QPS</strong></p>https://plumephp.com/shortlink10-deploy/Wed, 24 Sep 2025 17:28:36 +0800https://plumephp.com/shortlink10-deploy/<h1 id="短网址服务架构部署图示意">短网址服务架构部署图（示意）</h1> <pre tabindex="0"><code class="language-mermaid" data-lang="mermaid">flowchart TD subgraph Client [&#34;客户端/前端&#34;] Web[&#34;Web 页面&lt;br/&gt;首页/登录/Dashboard&#34;] Mobile[&#34;移动端浏览器&#34;] Dev[&#34;开发者（API Key调用）&#34;] end subgraph Edge [&#34;CDN / 反向代理&#34;] CDN[&#34;CDN/负载均衡&#34;] WAF[&#34;WAF / 防火墙&#34;] end subgraph App [&#34;应用层&#34;] API[&#34;API Gateway / Nginx-Ingress&#34;] Svc[&#34;短网址服务&lt;br/&gt;Go · Java · Python&#34;] Auth[&#34;认证服务&lt;br/&gt;JWT/OAuth&#34;] end subgraph CacheDB [&#34;存储层&#34;] Redis[&#34;(Redis缓存&lt;br/&gt;短链→长链映射)&#34;] DB[&#34;(MySQL / PostgreSQL&lt;br/&gt;短链 &amp; 用户 &amp; Key)&#34;] end subgraph Stats [&#34;统计与日志&#34;] MQ[&#34;(Kafka / RabbitMQ)&#34;] ETL[&#34;统计消费服务&lt;br/&gt;PV/UV聚合&#34;] Store[&#34;(Click Logs DB / ES)&#34;] end subgraph Monitoring [&#34;监控与运维&#34;] Prom[&#34;Prometheus&lt;br/&gt;监控采集&#34;] Grafana[&#34;Grafana&lt;br/&gt;监控面板&#34;] Alert[&#34;Alertmanager&lt;br/&gt;报警&#34;] Log[&#34;ELK / Loki&lt;br/&gt;日志中心&#34;] end Client --&gt;|HTTP/HTTPS| CDN CDN --&gt; WAF WAF --&gt; API API --&gt; Svc Svc --&gt; Auth Svc --&gt; Redis Svc --&gt; DB Svc --&gt; MQ MQ --&gt; ETL --&gt; Store Prom --&gt; Grafana Grafana --&gt; Alert Svc --&gt; Log DB --&gt; Log Redis --&gt; Log </code></pre><hr> <h1 id="架构说明">架构说明</h1> <h2 id="1-客户端层">1. 客户端层</h2> <ul> <li><strong>Web 页面</strong>：首页（生成短链）、Dashboard（管理/统计）、API 文档页。</li> <li><strong>移动端</strong>：浏览器访问，适配卡片式展示。</li> <li><strong>开发者</strong>：通过 API Key 调用接口生成短链。</li> </ul> <h2 id="2-接入层">2. 接入层</h2> <ul> <li><strong>CDN/负载均衡</strong>：加速访问、分发请求，缓解主服务压力。</li> <li><strong>WAF</strong>：拦截 SQL 注入/XSS/恶意请求。</li> <li><strong>API Gateway</strong>：统一路由，转发到应用服务。</li> </ul> <h2 id="3-应用层">3. 应用层</h2> <ul> <li> <p><strong>短网址服务（Svc）</strong></p>https://plumephp.com/shortlink09-checklist/Wed, 24 Sep 2025 15:28:36 +0800https://plumephp.com/shortlink09-checklist/<h2 id="1-功能检查">1. 功能检查</h2> <ul> <li><input disabled="" type="checkbox"> 首页可以成功生成短链（包含普通 URL、自定义短码、设置过期时间）。</li> <li><input disabled="" type="checkbox"> 短链跳转正常（存在短链 → 正常跳转；不存在/过期 → 错误页提示）。</li> <li><input disabled="" type="checkbox"> 登录/注册流程可用（注册 → 自动登录 → Dashboard）。</li> <li><input disabled="" type="checkbox"> Dashboard 短链管理列表正常（分页、搜索、修改、删除）。</li> <li><input disabled="" type="checkbox"> Dashboard 数据统计展示正确（趋势图、饼图、地图）。</li> <li><input disabled="" type="checkbox"> API Key 管理可用（新建/删除，调用 API 成功）。</li> <li><input disabled="" type="checkbox"> 自定义域名绑定校验流程正确。</li> <li><input disabled="" type="checkbox"> 错误码返回符合规范（code + message）。</li> </ul> <hr> <h2 id="2-性能检查">2. 性能检查</h2> <ul> <li><input disabled="" type="checkbox"> 单节点短链跳转 QPS ≥ 5k，P95 延迟 ≤ 100ms。</li> <li><input disabled="" type="checkbox"> 短链生成接口 QPS ≥ 500，平均延迟 ≤ 200ms。</li> <li><input disabled="" type="checkbox"> 数据库写入压力测试 ≥ 10w 条/天，查询延迟 ≤ 500ms。</li> <li><input disabled="" type="checkbox"> 统计聚合延迟 ≤ 5s，误差率 ≤ 1%。</li> <li><input disabled="" type="checkbox"> API 限流策略生效，超限返回 <code>130003</code>。</li> <li><input disabled="" type="checkbox"> 压测 24 小时运行，CPU ≤ 70%，内存无明显泄漏。</li> </ul> <hr> <h2 id="3-安全检查">3. 安全检查</h2> <ul> <li><input disabled="" type="checkbox"> 所有输入字段已做合法性校验，防止 SQL 注入 / XSS。</li> <li><input disabled="" type="checkbox"> 黑名单域名检测生效，恶意 URL 不可生成短链。</li> <li><input disabled="" type="checkbox"> 短链跳转强制 HTTPS（HSTS 生效）。</li> <li><input disabled="" type="checkbox"> 密码加密存储（BCrypt/Argon2），禁止明文。</li> <li><input disabled="" type="checkbox"> API Key 列表展示打码，返回日志中不包含完整 Token/密码。</li> <li><input disabled="" type="checkbox"> API Key 权限隔离，删除/过期后不可继续调用。</li> <li><input disabled="" type="checkbox"> CORS 配置合理，仅允许白名单域名访问。</li> <li><input disabled="" type="checkbox"> CSRF 防护生效（Token 或 SameSite Cookie）。</li> <li><input disabled="" type="checkbox"> 登录失败/异常调用有日志记录，可用于审计。</li> </ul> <h2 id="4-运维与监控">4. 运维与监控</h2> <ul> <li><input disabled="" type="checkbox"> 服务支持 <strong>健康检查接口</strong>（<code>/health</code>）。</li> <li><input disabled="" type="checkbox"> 部署支持 <strong>蓝绿/灰度发布</strong>，可快速回滚。</li> <li><input disabled="" type="checkbox"> 接入监控：QPS、延迟、错误率、缓存命中率。</li> <li><input disabled="" type="checkbox"> 接入日志：访问日志、错误日志，集中收集（ELK / Loki）。</li> <li><input disabled="" type="checkbox"> 短链点击量、API 调用量设置 <strong>告警阈值</strong>。</li> <li><input disabled="" type="checkbox"> 数据库备份策略就绪（每日/每周全量 + 增量）。</li> <li><input disabled="" type="checkbox"> Redis 缓存过期策略确认，保证一致性。</li> <li><input disabled="" type="checkbox"> SSL 证书部署并校验，过期前有续期提醒。</li> </ul> <h2 id="5-前端体验">5. 前端体验</h2> <ul> <li><input disabled="" type="checkbox"> 短链复制功能在主流浏览器/移动端可用。</li> <li><input disabled="" type="checkbox"> 二维码展示与下载正常。</li> <li><input disabled="" type="checkbox"> 移动端适配检查（表格 → 卡片式展示，按钮宽度 100%）。</li> <li><input disabled="" type="checkbox"> 多语言支持校验（错误提示/提示文案）。</li> <li><input disabled="" type="checkbox"> 错误/异常页面友好提示，提供「返回首页」按钮。</li> </ul> <h2 id="6-文档与交付">6. 文档与交付</h2> <ul> <li><input disabled="" type="checkbox"> API 文档完整（Swagger / OpenAPI 导出）。</li> <li><input disabled="" type="checkbox"> 错误码文档对齐（错误码 ↔ 前端提示）。</li> <li><input disabled="" type="checkbox"> 运维文档更新（部署方式、回滚方案、监控指标）。</li> <li><input disabled="" type="checkbox"> 测试用例执行完毕（功能、性能、安全覆盖）。</li> <li><input disabled="" type="checkbox"> 产品说明文档归档（供运营/客服使用）。</li> </ul> <h1 id="上线流程建议">上线流程建议</h1> <ol> <li><strong>预发布环境</strong>：全量功能测试 + 压测。</li> <li><strong>灰度发布</strong>：部分用户访问新版本，监控 QPS/延迟/错误率。</li> <li><strong>全量发布</strong>：完成流量切换，旧版本下线。</li> <li><strong>回滚预案</strong>：遇到大规模错误/性能问题时，立即回滚到上一版本。</li> </ol> <p>📌 这样一份 <strong>Go-Live Checklist</strong> 可以作为「发版前最后一道关口」，保证功能、性能、安全、运维都不掉链子。</p>https://plumephp.com/shortlink08-security/Wed, 24 Sep 2025 14:28:36 +0800https://plumephp.com/shortlink08-security/<h2 id="1-输入校验与防注入">1. 输入校验与防注入</h2> <ul> <li> <p><strong>SQL 注入</strong></p> <ul> <li>在生成短链 API 中输入恶意 URL：<code>https://abc.com' OR '1'='1</code></li> <li>在搜索接口传入注入语句：<code>s.io/abc123' UNION SELECT ...</code></li> <li>预期：系统返回参数错误（100001），无数据泄露。</li> </ul> </li> <li> <p><strong>XSS 攻击</strong></p>https://plumephp.com/shortlink07-benchmark/Wed, 24 Sep 2025 13:28:36 +0800https://plumephp.com/shortlink07-benchmark/<h2 id="1-短链跳转性能">1. 短链跳转性能</h2> <ul> <li> <p><strong>目标</strong>：跳转延迟 ≤ 50ms（内网环境），单节点 QPS ≥ 5k。</p> </li> <li> <p><strong>测试点</strong>：</p> <ul> <li>单用户访问短链 → 响应时间统计（首字节、总耗时）。</li> <li>并发 100/1000/5000 用户同时访问同一短链。</li> <li>并发 100/1000/5000 用户同时访问不同短链（随机）。</li> <li>Redis 缓存命中时延迟统计 vs 未命中时延迟统计。</li> </ul> </li> <li> <p><strong>预期结果</strong>：</p>https://plumephp.com/shortlink06-test/Wed, 24 Sep 2025 12:28:36 +0800https://plumephp.com/shortlink06-test/<h2 id="1-首页短链生成页">1. 首页（短链生成页）</h2> <h3 id="11-正常场景">1.1 正常场景</h3> <ul> <li>输入合法 URL，点击生成 → 返回短链 &amp; 二维码。</li> <li>输入合法 URL + 自定义短码 → 返回短链（短码为用户指定值）。</li> <li>输入合法 URL + 设置过期时间 → 返回带过期信息的短链。</li> </ul> <h3 id="12-异常场景">1.2 异常场景</h3> <ul> <li>输入空链接 → 提示「请输入有效链接」。</li> <li>输入非 http/https 链接 → 提示「请输入有效链接」。</li> <li>输入超长链接（&gt;2048） → 提示「链接过长」。</li> <li>输入短码已存在 → 提示「短码已被使用」。</li> <li>输入黑名单域名 → 提示「该链接无法生成短网址」。</li> </ul> <h3 id="13-边界场景">1.3 边界场景</h3> <ul> <li>多次点击「生成短链」 → 仅生成一次（按钮禁用 Loading）。</li> <li>游客用户生成短链 → 无历史记录。</li> </ul> <hr> <h2 id="2-登录--注册">2. 登录 / 注册</h2> <h3 id="21-正常场景">2.1 正常场景</h3> <ul> <li>注册：输入合法邮箱+密码 → 注册成功 → 自动登录跳转 Dashboard。</li> <li>登录：输入正确邮箱+密码 → 登录成功 → 跳转 Dashboard。</li> </ul> <h3 id="22-异常场景">2.2 异常场景</h3> <ul> <li>注册时输入已注册邮箱 → 提示「邮箱已被注册」。</li> <li>注册时邮箱格式错误 → 提示「邮箱格式错误」。</li> <li>登录时输入错误邮箱/密码 → 提示「账号或密码错误」。</li> <li>登录时使用过期 Token → 提示「登录已过期，请重新登录」。</li> </ul> <h3 id="23-边界场景">2.3 边界场景</h3> <ul> <li>密码和确认密码不一致 → 提示「两次密码不一致」。</li> <li>注册时未勾选服务协议 → 注册按钮禁用。</li> </ul> <hr> <h2 id="3-dashboard">3. Dashboard</h2> <h3 id="31-短链管理">3.1 短链管理</h3> <p><strong>正常场景</strong></p>https://plumephp.com/shortlink04-wireframe/Wed, 24 Sep 2025 11:28:36 +0800https://plumephp.com/shortlink04-wireframe/<hr> <h2 id="1-首页短链生成">1. 首页（短链生成）</h2> <p><strong>布局要点</strong>：</p> <ul> <li> <p>顶部导航栏</p> <ul> <li>左侧：LOGO / 产品名</li> <li>右侧：按钮 → 登录 / 注册 / Dashboard</li> </ul> </li> <li> <p>主体区域</p> <ul> <li>[TextBox] 输入长链</li> <li>[TextBox] 自定义短码（可选）</li> <li>[Dropdown] 有效期（7天/30天/永久）</li> <li>[Button, Primary] 生成短链</li> </ul> </li> <li> <p>结果展示区域（生成后显示）</p>https://plumephp.com/shortlink05-ui/Wed, 24 Sep 2025 10:28:36 +0800https://plumephp.com/shortlink05-ui/<h2 id="1-首页短链生成页">1. 首页（短链生成页）</h2> <p><strong>目标</strong>：让用户在最短路径内完成「输入长链 → 获取短链+二维码」</p> <h3 id="模块与要点">模块与要点</h3> <ol> <li> <p><strong>输入区域</strong></p> <ul> <li> <p>输入框：支持粘贴长链，自动去掉前后空格。</p> </li> <li> <p>占位符示例：<code>请输入或粘贴长链接</code></p>https://plumephp.com/shortlink03-code/Wed, 24 Sep 2025 10:27:37 +0800https://plumephp.com/shortlink03-code/<h1 id="短网址服务错误码规范整数版1011121314-前缀">短网址服务错误码规范（整数版，10/11/12/13/14 前缀）</h1> <h2 id="1-错误码设计规则">1. 错误码设计规则</h2> <ul> <li> <p>格式：<code>XXYYZZ</code></p> <ul> <li><code>XX</code>：模块前缀（两位整数）</li> <li><code>YY</code>：子分类（可选）</li> <li><code>ZZ</code>：错误序号（递增）</li> </ul> </li> </ul> <h2 id="2-模块划分">2. 模块划分</h2> <ul> <li><strong>10xxxx</strong> → 通用错误（Common）</li> <li><strong>11xxxx</strong> → 用户与认证（Auth/User）</li> <li><strong>12xxxx</strong> → 短链服务（URL/Shorten）</li> <li><strong>13xxxx</strong> → API &amp; Dashboard</li> <li><strong>14xxxx</strong> → 统计与报表（Stats/Report）</li> </ul> <hr> <h2 id="3-错误码表">3. 错误码表</h2> <h3 id="通用错误10xxxx">通用错误（10xxxx）</h3> <table> <thead> <tr> <th>错误码</th> <th>HTTP 状态</th> <th>描述</th> <th>前端提示</th> </tr> </thead> <tbody> <tr> <td>100001</td> <td>400</td> <td>参数不合法</td> <td>输入有误，请检查后重试</td> </tr> <tr> <td>100002</td> <td>429</td> <td>请求过于频繁</td> <td>操作过于频繁，请稍后再试</td> </tr> <tr> <td>100003</td> <td>500</td> <td>系统内部错误</td> <td>系统开小差了，请稍后再试</td> </tr> </tbody> </table> <hr> <h3 id="用户与认证11xxxx">用户与认证（11xxxx）</h3> <table> <thead> <tr> <th>错误码</th> <th>HTTP 状态</th> <th>描述</th> <th>前端提示</th> </tr> </thead> <tbody> <tr> <td>110001</td> <td>400</td> <td>邮箱格式不合法</td> <td>邮箱格式错误，请重新输入</td> </tr> <tr> <td>110002</td> <td>409</td> <td>邮箱已注册</td> <td>该邮箱已被注册，请直接登录</td> </tr> <tr> <td>110003</td> <td>401</td> <td>登录失败（账号/密码错误）</td> <td>邮箱或密码不正确，请重试</td> </tr> <tr> <td>110004</td> <td>401</td> <td>Token 无效或过期</td> <td>登录已过期，请重新登录</td> </tr> <tr> <td>110005</td> <td>403</td> <td>权限不足</td> <td>您没有权限执行此操作</td> </tr> <tr> <td>110006</td> <td>400</td> <td>Refresh Token 无效</td> <td>登录状态已失效，请重新登录</td> </tr> </tbody> </table> <h3 id="短链服务12xxxx">短链服务（12xxxx）</h3> <table> <thead> <tr> <th>错误码</th> <th>HTTP 状态</th> <th>描述</th> <th>前端提示</th> </tr> </thead> <tbody> <tr> <td>120001</td> <td>400</td> <td>长链格式不合法</td> <td>链接格式不正确，请输入有效网址</td> </tr> <tr> <td>120002</td> <td>400</td> <td>长链过长</td> <td>链接过长，请缩短后重试</td> </tr> <tr> <td>120003</td> <td>403</td> <td>URL 在黑名单中</td> <td>该链接无法生成短网址</td> </tr> <tr> <td>120004</td> <td>409</td> <td>自定义短码已存在</td> <td>短码已被使用，请更换后重试</td> </tr> <tr> <td>120005</td> <td>404</td> <td>短链不存在</td> <td>短链不存在或已被删除</td> </tr> <tr> <td>120006</td> <td>410</td> <td>短链已过期</td> <td>短链已过期，请重新生成</td> </tr> <tr> <td>120007</td> <td>500</td> <td>短链生成失败</td> <td>短链生成失败，请稍后再试</td> </tr> </tbody> </table> <h3 id="api--dashboard13xxxx">API &amp; Dashboard（13xxxx）</h3> <table> <thead> <tr> <th>错误码</th> <th>HTTP 状态</th> <th>描述</th> <th>前端提示</th> </tr> </thead> <tbody> <tr> <td>130001</td> <td>401</td> <td>API Key 无效</td> <td>API Key 无效，请检查配置</td> </tr> <tr> <td>130002</td> <td>403</td> <td>API Key 权限不足</td> <td>API Key 权限不足，请联系管理员</td> </tr> <tr> <td>130003</td> <td>429</td> <td>API 调用超限</td> <td>API 调用次数超出限制，请稍后再试</td> </tr> <tr> <td>130004</td> <td>404</td> <td>短链记录未找到</td> <td>未找到相关短链记录</td> </tr> <tr> <td>130005</td> <td>400</td> <td>参数错误（分页/筛选非法）</td> <td>请求参数错误，请检查后重试</td> </tr> </tbody> </table> <h3 id="统计与报表14xxxx">统计与报表（14xxxx）</h3> <table> <thead> <tr> <th>错误码</th> <th>HTTP 状态</th> <th>描述</th> <th>前端提示</th> </tr> </thead> <tbody> <tr> <td>140001</td> <td>404</td> <td>没有找到统计数据</td> <td>暂无统计数据</td> </tr> <tr> <td>140002</td> <td>400</td> <td>时间区间不合法</td> <td>时间范围选择有误</td> </tr> <tr> <td>140003</td> <td>500</td> <td>聚合统计失败</td> <td>数据统计失败，请稍后再试</td> </tr> </tbody> </table> <h2 id="4-返回示例">4. 返回示例</h2> <h3 id="成功">成功</h3> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-json" data-lang="json"><span class="line"><span class="cl"><span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;code&#34;</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;message&#34;</span><span class="p">:</span> <span class="s2">&#34;success&#34;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;data&#34;</span><span class="p">:</span> <span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;short_url&#34;</span><span class="p">:</span> <span class="s2">&#34;https://s.io/abc123&#34;</span> </span></span><span class="line"><span class="cl"> <span class="p">}</span> </span></span><span class="line"><span class="cl"><span class="p">}</span> </span></span></code></pre></div><h3 id="短码冲突120004">短码冲突（120004）</h3> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-json" data-lang="json"><span class="line"><span class="cl"><span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;code&#34;</span><span class="p">:</span> <span class="mi">120004</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;message&#34;</span><span class="p">:</span> <span class="s2">&#34;Custom short code already exists&#34;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;data&#34;</span><span class="p">:</span> <span class="kc">null</span> </span></span><span class="line"><span class="cl"><span class="p">}</span> </span></span></code></pre></div><h3 id="token-过期110004">Token 过期（110004）</h3> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-json" data-lang="json"><span class="line"><span class="cl"><span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;code&#34;</span><span class="p">:</span> <span class="mi">110004</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;message&#34;</span><span class="p">:</span> <span class="s2">&#34;Token expired or invalid&#34;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;data&#34;</span><span class="p">:</span> <span class="kc">null</span> </span></span><span class="line"><span class="cl"><span class="p">}</span> </span></span></code></pre></div><h3 id="api-超限130003">API 超限（130003）</h3> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-json" data-lang="json"><span class="line"><span class="cl"><span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;code&#34;</span><span class="p">:</span> <span class="mi">130003</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;message&#34;</span><span class="p">:</span> <span class="s2">&#34;API rate limit exceeded&#34;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;data&#34;</span><span class="p">:</span> <span class="kc">null</span> </span></span><span class="line"><span class="cl"><span class="p">}</span> </span></span></code></pre></div><h1 id="接口与错误码映射表">接口与错误码映射表</h1> <h2 id="1-用户认证模块">1. 用户认证模块</h2> <h3 id="post-apiauthregister"><code>POST /api/auth/register</code></h3> <ul> <li> <p>成功 → <code>code = 0</code></p>https://plumephp.com/shortlink02-fdd/Wed, 24 Sep 2025 10:27:36 +0800https://plumephp.com/shortlink02-fdd/<hr> <h1 id="短网址服务功能设计文档fdd-v11">短网址服务功能设计文档（FDD v1.1）</h1> <h2 id="1-概述">1. 概述</h2> <p>本文档基于<a href="https://www.plumephp.com/shortlink01-prd">PRD 文档</a>，对短网址服务的功能模块、交互逻辑、接口协议、数据结构进行细化，旨在保障开发、测试和产品的高效协作。</p> <hr> <h2 id="2-系统模块划分">2. 系统模块划分</h2> <ul> <li><strong>前端模块</strong>：长链输入生成页面、用户登录注册、Dashboard（短链管理、统计分析、API Key 管理）。</li> <li><strong>后端模块</strong>：短链生成与跳转、API 服务、用户与权限管理、统计分析、风控与安全策略。</li> <li><strong>数据存储</strong>：MySQL（持久化）、Redis（缓存 + 计数器）、对象存储（二维码文件）。</li> <li><strong>运维支持</strong>：Nginx/Gateway、Docker/K8s、监控告警。</li> </ul> <h2 id="3-功能设计详细">3. 功能设计（详细）</h2> <h3 id="31-短网址生成">3.1 短网址生成</h3> <p><strong>功能点</strong>：</p>https://plumephp.com/shortlink01-prd/Wed, 24 Sep 2025 10:27:35 +0800https://plumephp.com/shortlink01-prd/<h2 id="短网址服务系统">短网址服务系统</h2> <hr> <h2 id="1-文档信息">1. 文档信息</h2> <ul> <li><strong>文档版本</strong>：V1.0</li> <li><strong>编写人</strong>：xxx</li> <li><strong>评审人</strong>：xxx</li> <li><strong>创建日期</strong>：2025-09-24</li> <li><strong>最后修改日期</strong>：2025-09-25</li> </ul> <hr> <h2 id="2-背景与目标">2. 背景与目标</h2> <h3 id="21-背景">2.1 背景</h3> <p>在社交媒体、电商推广、活动运营等场景中，长链接往往冗长、不便于传播，甚至在部分平台（如短信、微博、微信）中容易折行或被截断。短网址服务通过生成简洁的短链和二维码，提高了链接的分享体验，并能在此基础上提供统计、管理和 API 接入能力。</p>https://plumephp.com/shortlink00-business-plan/Wed, 24 Sep 2025 09:27:35 +0800https://plumephp.com/shortlink00-business-plan/<h2 id="一执行摘要executive-summary">一、执行摘要（Executive Summary）</h2> <ul> <li> <p><strong>项目概述</strong><br> 短网址服务是一款提供 <strong>长链接缩短、访问统计、二维码生成、用户管理</strong> 的 SaaS 平台，支持 API 接入与可视化 Dashboard，满足个人用户、企业用户及营销平台的多样化需求。</p>