站点扩展启用前检查框架

功能与适用场景
站点扩展是在论坛之外为整个站点增加通用能力的组件，例如统一登录入口、内容推送、访问统计或缓存加速。它适合需要跨页面复用功能的站点，也适合在多站点环境中统一管理能力。站点扩展的影响范围通常大于论坛内扩展，一旦出错可能波及全部页面，因此启用前的检查应更严格，重点放在依赖关系与全局影响上。

使用步骤
第一步，列出扩展的依赖清单，包括运行环境版本、数据库类型、缓存服务和外部接口，逐项确认当前环境满足要求。第二步，在隔离环境启用扩展，观察它对全局请求链路的影响，记录响应时间、错误率和资源占用变化。第三步，检查扩展与现有站点组件的冲突点，例如是否重复注册路由、是否覆盖全局配置、是否修改公共响应头。第四步，审查扩展的权限模型，确认管理入口、数据读写和接口调用都遵循最小权限原则。第五步，制定回滚方案，明确停用顺序、数据清理方式和验证步骤，并确保回滚过程不依赖扩展自身功能。

注意事项
避免同时启用多个功能重叠的站点扩展，重叠会导致行为不可预测。关注扩展是否在页面底部注入脚本或修改全局模板，这类改动容易与主题和其他扩展冲突。检查扩展的日志输出是否包含敏感信息，避免在排查问题时泄露用户数据。若扩展需要外部服务，应确认网络不可用时的降级表现，防止站点整体不可访问。定期复核扩展的更新记录，长期未更新的扩展应列入替换计划。最后，为每个扩展设置启用窗口和观察期，期间保持监控告警开启。

常见问题
启用后全站样式异常，通常是扩展注入了全局样式或脚本，可先停用扩展再逐项排查。部分页面报错而其他页面正常，说明扩展的路由或钩子只覆盖了特定路径。管理后台无法打开，可能与扩展注册的管理路由冲突有关。扩展停用后站点仍未恢复，需检查是否残留全局配置或缓存未清理。