一、一句话总结
我的个人博客于5月底正式上线。上线初期仅完成了基础可用的核心功能，能正常访问、展示内容，但存在样式适配异常、服务器被恶意扫描、部分资源加载异常、代码无注释等诸多细节问题。
过去半个月的所有工作，核心围绕问题修复、体验优化、安全加固、代码维护展开，没有新增大型功能，只为让网站从“勉强能打开”的初始状态，迭代为“稳定、安全、好用、易维护”的成熟状态。
本次迭代共计3次代码提交，针对性解决了上线后暴露的各类问题，完成多项细节优化。
二、样式问题修复：解决页面各类显示异常
针对后台管理页面出现的图标错乱、导航栏浮动、虚假报错横幅三大视觉及功能bug，逐一定位根源并彻底修复，统一页面展示效果。
- 后台图标乱码成方块
上线后发现，后台管理菜单、功能按钮前的所有Font Awesome图标，全部异常显示为空白小方块，完全丧失视觉标识作用。
问题根源：此前为强化网站安全，配置了“仅允许加载本站资源”的访问规则，而博客图标字体依赖外部CDN加载，被本地安全策略拦截，导致图标资源加载失败。
解决方案：调整站点安全规则，将图标字体对应的CDN域名加入白名单，双向放行资源请求，彻底解决图标加载异常问题。 - 顶部导航栏跟随页面滚动消失
后台页面纵向滚动时，顶部全局导航栏会跟随页面内容一同滑动，滚动后直接消失，无法实现置顶常驻，严重影响后台操作便捷性。
问题根源：顶部导航栏的样式代码重复编写在两个不同配置文件中，两套样式规则相互冲突，浏览器无法正常解析渲染置顶效果。
解决方案：删除冗余重复的样式代码，将导航栏样式统一整合至单一配置文件，补充固定置顶样式，实现页面滚动时顶部导航栏常驻顶部的效果。 - 后台常驻虚假错误横幅
后台页面底部始终悬浮一条黄色报错横幅，提示“发生未处理的错误”，但实际检测网站运行日志、功能状态，无任何异常报错，属于纯前端展示bug。
问题根源：错误提示横幅的默认样式配置错误，原本设计为“真实报错时动态展示、无错时隐藏”，被误配置为默认常驻显示。
解决方案：修正组件默认样式，恢复“默认隐藏、报错触发时自动展示”的逻辑，杜绝虚假报错提示，保证后台界面整洁干净。
三、服务器安全加固：拦截恶意扫描攻击
网站上线稳定运行后，通过服务器运行日志发现，持续有大量自动化扫描脚本、爬虫工具对站点进行恶意探测，频繁请求各类敏感文件与漏洞路径。
这类恶意请求虽会返回404状态码，不会直接攻破站点、造成数据泄露，但会大量刷脏服务器日志、占用少量带宽资源，长期放任存在存在安全隐患。为此我在Nginx层面配置了三层拦截策略，从源头拦截恶意访问。 - 按文件后缀拦截
针对性拦截 .env、.yml、.json、.sql、.php 等核心配置、数据库、脚本类敏感文件的访问请求，禁止外部探测站点核心隐私文件。 - 按工具特征拦截
匹配主流漏洞扫描工具、爬虫脚本的UA特征，对这类恶意工具发起的请求直接拒绝访问，拦截自动化探测行为。 - 按漏洞路径拦截
拦截Spring Boot Actuator、WordPress后台等常见漏洞探测路径、敏感后台路径的访问请求，规避通用漏洞扫描风险。
配置生效后，所有恶意扫描请求均在Nginx前置层面被直接拦截，不会穿透至后端服务，大幅提升了站点安全性，同时净化了服务器日志。
四、资源代理修复：解决Blazor静态资源404
本博客后台基于Blazor Server开发，存在部分专属路径的静态资源文件。原有Nginx代理配置未适配这类特殊资源路径，导致后台部分样式、组件资源加载失败，统一返回404错误。
针对该问题，我新增两条Nginx路径匹配规则，专门适配、代理Blazor后台的静态资源目录，同时配置了合理的缓存时效，既解决了资源404问题，又提升了资源二次加载速度，优化后台访问体验。
五、代码注释完善：提升项目长期可维护性
本次迭代耗时最长、最基础也最关键的工作，就是全核心模块代码补注释。个人项目迭代周期不固定，长期不维护容易遗忘代码逻辑，完善注释是为了方便后续迭代、复盘、接手维护，做到“半年后回头看，依然能快速读懂”。
本次注释全覆盖项目四层核心代码，精准标注各模块功能、逻辑、用途： - API 接口层
完善项目启动流程、服务注册机制、中间件执行管道注释；补充安全响应头、请求日志、日志清理、数据备份、RSS订阅等核心控制器与中间件的逻辑注释。 - 业务服务层
细化缓存服务、邮件推送服务、人机验证服务的执行逻辑、调用场景、参数说明注释。 - 领域模型层
补充刷新令牌实体的字段含义、生成规则、过期逻辑、业务用途注释。 - 数据访问层
完善数据库上下文配置、刷新令牌仓储、站点全局设置服务的读写逻辑、数据持久化规则注释。
六、前端细节体验优化
在修复bug、加固安全的同时，针对用户浏览体验做了多项轻量化优化，解决页面展示短板： - 归档页面折叠优化
随着文章数量增加，归档页面内容冗长、滚动成本高。新增按年份、月份折叠/展开功能，默认仅展开最近一年文章，页面更简洁，查找内容更高效。 - 首页加载异常修复
修复站点静态构建后，首页文章列表偶尔为空的加载异常问题，保证首页内容稳定展示。 - 页面结构标准化
统一全站页面标题层级规范，优化meta标签配置，既提升页面整洁度，也对SEO友好。
七、迭代数据一览
统计项目 具体数据
代码提交次数 3 次
提交时间 6月7日（2次）、6月12日（1次）
核心BUG修复 图标加载异常、导航栏不置顶、虚假报错横幅、Nginx恶意扫描拦截、Blazor静态资源404
前端体验优化 归档折叠功能、首页数据加载修复、全站页面结构与meta标签优化
代码维护工作 四层核心业务代码全覆盖详细注释
八、半月工作小结
过去半个月，没有花哨的新功能开发，所有工作都聚焦于查漏补缺、夯实基础。
从上线初期“能跑、能看”的基础状态，通过样式修复、安全加固、资源适配、代码规范化、前端体验微调，让整个博客站点的稳定性、安全性、可维护性、用户体验全方位升级。
技术开发从来不是一蹴而就的事情，新功能是增量迭代，修bug、做优化、规整代码是存量夯实。把基础体验打磨到位，才能为后续新增功能、长期稳定运行筑牢根基。
💬 评论列表 (0)
加载评论中...
💬 发表评论