教程库 · 分类
编程上线教程：10 个可执行教程
本地能跑不等于线上能用。这里按上线前检查拆：环境变量、路径、跨域、HTTPS、缓存、限流和回滚。
适合：开发、独立开发者 目标：把环境、路径、CORS、证书、缓存和限流排清
边界：步骤是通用做法，平台/客户规则以实际页面为准；不承诺排名、过稿或收益。
边界：步骤是通用做法，平台/客户规则以实际页面为准；不承诺排名、过稿或收益。
先做哪 3 个
01
本地能跑线上 404：先查文件名大小写，再查构建产物
定位大小写、扩展名和路径别名导致的资源 404，用构建产物和大小写敏感环境验证修复。
入门
看完整内容 →02密钥被打进了前端包：先分清公开变量和私密变量
识别构建时被内联到前端的变量，把密钥移到服务端并轮换已泄露的凭证。
进阶
看完整内容 →03单页应用刷新就 404：把未知路径回退到 index.html
配置服务器或托管平台的路由回退规则，让前端路由的深链接刷新和直接访问都能正常打开。
入门
看完整内容 →其余 7 条
前 3 条已在上面展开；这里是余下 7 条，10 条全部可点。
编程上线
换台电脑就构建失败：锁 Node 版本再清缓存重装
用版本文件和依赖锁把本地与 CI 的 Node 版本对齐，解决因版本差异导致的构建失败。
入门
看完整内容 →编程上线接口跨域被拦：先看预检请求有没有通过
通过浏览器网络面板定位预检失败原因，在服务端正确配置来源、方法和请求头。
进阶
看完整内容 →编程上线上线后图片字体全 404：查 base 路径和 CDN 前缀
区分构建路径、部署子目录和 CDN 前缀三种原因，让静态资源在线上正确加载。
入门
看完整内容 →编程上线域名能打开却提示不安全：补全证书链再强制跳转
检查证书有效期、域名覆盖和中间证书，配置 HTTP 到 HTTPS 跳转并覆盖主域名与 www。
进阶
看完整内容 →编程上线部署成功页面还是旧的：静态资源加哈希，入口文件别缓存
用带哈希的静态资源和短缓存的入口文件，让新版本发布后用户立即拿到更新。
进阶
看完整内容 →编程上线小站被爬虫拖垮：先限流再加缓存，别只写 robots
通过访问日志识别异常抓取，用限流、缓存和 robots 声明降低负载，同时不误伤正常用户。
进阶
看完整内容 →编程上线数据库连接数打满：先调池上限再查慢查询
通过连接池上限、超时设置和慢查询排查，解决高峰期连接耗尽导致的接口报错。
进阶
看完整内容 →这个分类最容易踩的坑
- 本地能跑就上线
- 不看日志
怎么用这一页
1. 选一条
按你本周真实交付物选，不要从第一条开始收藏。
2. 跑一遍
打开详情，按步骤做，不要只看摘要。
3. 用检查点验收
检查点不过，先改再交付；平台/客户规则优先。
同类分类
更新时间：2026-10-29 · 本页 10 条内容均为独立详情页；分类只是入口，不是把内容复制一遍。