优化营商环境的收获和感悟

网站动态加载的内容无法被搜索引擎抓取

1. 启用服务器端渲染（SSR）或预渲染（Prerender），生成静态 HTML；2. 配置动态渲染规则，给搜索引擎返回静态内容；3. 利用 AJAX 爬虫规范（如 #! 标识），引导搜索引擎抓取；4. 将关键动态内容添加到 sitemap.xml，提升收录概率

服务器网卡流量过高，网络拥堵

1. 用 iftop 命令查看流量占用情况，排查是否有 DDoS 攻击；2. 限制非必要端口的网络访问，开启防火墙防护；3. 采用 CDN 分流静态资源流量，减轻源站压力；4. 升级服务器带宽，或配置流量整形策略

网站 localStorage 存储数据后无法读取

1. 检查存储的键名是否正确，无拼写错误或大小写不一致；2. 修复数据读取逻辑，确保正确反序列化（如 JSON.parse）；3. 核实浏览器是否开启隐私模式（隐私模式下 localStorage 可能受限）；4. 检查存储数据大小是否超过限制，清理无用数据

网站后台模块无法加载

1. 检查模块是否正确安装，文件是否完整；2. 核实模块配置是否正确，是否启用；3. 修复模块加载逻辑，避免依赖缺失；4. 查看模块加载日志，排查错误原因

网站表格导出 Excel 时中文文件名乱码

1. 检查文件名编码格式，采用 UTF-8 编码并进行 URL 编码；2. 修复后端响应头的 Content-Disposition 配置，正确设置文件名；3. 核实浏览器是否支持中文文件名，必要时使用拼音或英文命名；4. 测试不同浏览器的下载效果，确保文件名正常显示

网站打印预览显示异常

1. 优化打印 CSS，确保预览样式正确；2. 修复打印预览中图片缺失问题；3. 确保打印预览中内容完整，不被截断；4. 测试不同浏览器打印预览，统一优化

网站后台管理系统权限分配后无效果

1. 检查权限分配逻辑，是否正确关联角色与菜单 / 操作；2. 修复权限校验接口，确保操作时实时校验权限；3. 核实用户是否已关联正确角色，无角色分配错误；4. 刷新权限缓存，处理权限更新延迟场景

网站在线编辑文档格式丢失

1. 确保文档编辑插件支持对应的格式（如 docx、markdown）；2. 修复文档保存时的格式转换逻辑；3. 避免使用过于复杂的格式（如特殊字体、复杂表格）；4. 测试不同浏览器，排查兼容性问题

网站下载功能异常，文件无法下载

1. 检查下载文件路径是否正确，文件是否存在；2. 核实 Web 服务器是否允许下载该类型文件（MIME 类型配置）；3. 调整文件权限，确保用户有读取下载权限；4. 增加下载进度提示，排查网络中断问题