网站构建秘籍：十年后端经验谈框架选型与设计原则

　　页面崩在真机那一刻，我正把热咖啡往杯沿凑，手抖没沾到嘴，倒是洒了两滴在键盘F键上——那键现在按下去还带点涩。王磊在隔间喊“后端哥你快看下H5白屏”，声音盖不过隔壁组开的腾讯会议外放，女声一字一顿：“……所以这个埋点字段必须对齐PRD第三页表二。”

　　我切过去看控制台，Safari真机调试里报错是`ReferenceError: Can't find variable: __webpack_require__`。不是Vue版本冲突，不是polyfill漏了，是构建时webpack把node_modules里某个包的require逻辑抽成单独chunk，但index.html里script标签压根没加载它——打包完的html里只写了main.js和vendor.js，那个叫`chunk-7b2e.js`的玩意儿压根没被引用。我原以为是public目录下index.html手动改过，结果打开一看，连doctype都没动过。是vue-cli-service build自个儿干的，记不清是哪个版本了，大概那个数。

文章配图，仅供参考

　　水杯底结了一圈渍，灰白色，一圈硬边，像水垢又像咖啡渍干透后的结晶。机箱风扇一直在转，嗡嗡的，但不吵，是那种你坐定三分钟就自动忽略的背景音。李薇端着泡面从工位路过，掀开盖子那一下热气全糊在她眼镜片上，她用袖口抹了一下，又继续往前走。我说你别急着吃，等会儿联调完再吸溜——她头也不回：“前端早跑通了，我这刚联完后端接口，200。”

　　框架选型？去年春天那会儿我们砍掉第三个选型方案，就因为产品经理盯着Koa的中间件写法问：“这个next()要是忘了写，是不是所有后续逻辑都卡死？”——问得特真诚，不带讽刺。张主任坐在小会议室里，面前摊着三份PDF，手指按在Express文档第12页上，说“这个error-handling middleware顺序太反直觉”。他最后拍板用NestJS，理由是“Typescript支持好”，可直到上线前一周，他还在问TypeORM里save()和insert()到底差在哪条SQL语句上。我们没敢告诉他，其实就差一个RETURNING子句，PostgreSQL才认，MySQL直接报错，但我们用的是MySQL。

　　构建进度条卡在百分之八十七。不是卡，是停住不动，光标还在闪。你猜我在等啥？等eslint-loader吐完最后三十行warning。不是语法错误，是“no-console”和“max-len”被团队开了又关、关了又开——上周四凌晨两点发版前，我手动删了node_modules重装，就为让它过掉那个98分的code climate分数。分数高了，上线却慢了四十二秒，缓存没刷，用户点进活动页第一眼看见的是去年国庆的Banner。还原度？设计师后来截图问我：“为什么按钮圆角在iPhone上比设计稿少两个像素？”我没答，因为根本不是CSS问题，是Safari渲染层对border-radius做了亚像素截断，跟后端没关系，也跟框架没关系，纯属真机玄学。

　　外卖的塑料袋响个不停，搁在椅子扶手上，每次我抬腿蹭一下就窸窣一声。桌上的数据线缠成一团，Type-C和Lightning拧着劲儿，像DNA双螺旋。我不扯它，扯了更乱。这跟选型一样，你越想捋清逻辑链条，越发现链路里全是毛刺——React Router v6强制用createBrowserRouter，但uni-app里你得自己hack history.pushState；Nuxt3的useAsyncData默认挂载时执行，可某些老设备首次触发要等300ms触摸延迟过了才响应。这些事，文档不写，论坛没人提，只有你在线上白屏时，盯着Sentry里一串`undefined is not an object (evaluating 'r.data')`慢慢拼出来。

　　优胜劣汰不是口号。是去年春天线上事故复盘会上，运营突然插话：“你们能不能别动CDN配置？上个月切了新CDN，我后台报表里转化率掉了三个点。”我们查日志查了三天，发现不是缓存策略错了，是新CDN节点对HTTP/2 Server Push处理异常，把首页CSS的preload头当垃圾丢弃了。最终没动CDN，是改了Vite的build.rollupOptions.output.manualChunks逻辑，把CSS单独拎出来，明文写进html。技术上倒退，效果上稳了。张主任当时敲桌子说：“这就叫妥协的艺术。”我心想，这不是艺术，是血亏之后的止损点。可这话我没说出口，因为王磊正举着手机冲进来：“iOS微信里点击跳转，地址栏URL变成一串base64，分享出去直接404！”

　　我打开电脑，Chrome开发者工具里Network面板开着，但没点刷新，就干看着。旁边有人在钉钉语音问：“缓存没刷是吧？”我说不是缓存的事。他说那是不是服务端重定向配置错了？我说也不是。其实是PWA manifest.json里start_url写成了相对路径，微信内置浏览器读取时自动补了当前域，但用户分享时拿的是完整URL，二级路径被截断了。这问题跟框架无关，跟设计稿无关，跟任何原则都无关，纯粹是写manifest时手滑多敲了个点。优胜劣汰筛到⭐️⭐️⭐️⭐️留下的不是最优解，是那个能扛住手滑、网络抖动、旧机型降级、还有产品半夜改需求的壳子。

　　我原以为选对框架就能躲开大部分坑，结果发现框架只是把坑换个位置埋。现在我把Node升级脚本改成每季度手动跑一次，npm audit --audit-level high 之前先备份package-lock.json。至于下次要不要换Bun？等等再说。手边这个项目还没拆完微前端，vite.config.ts里define还有六个环境变量没理清楚，先让王磊把iOS真机白屏的case录个视频发我——我看一眼就知道是不是路由守卫里用了await但没catch，还是他把useRoute()写在了computed外面。

（编辑：52站长网）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!