Jetty项目部署扫描器默认行为与文档不符问题解析

在Jetty服务器12.1.0.alpha2版本及更早版本中，部署扫描器(Deployment Scanner)模块存在一个值得注意的行为差异：其实际运行时的默认配置与官方文档描述不符。这个问题可以追溯到至少Jetty 9.0.2版本，持续存在于多个主要版本中。

问题本质

根据Jetty 12操作指南文档，部署扫描器默认应该是静态部署模式（scanInterval=0），这意味着需要重启Jetty才能生效任何部署变更。然而实际运行时，系统却默认启用了10秒间隔的热部署扫描，这与文档描述完全相反。

有趣的是，在Jetty 10的文档中，描述又变成了默认1秒扫描间隔的热部署模式，但实际代码中仍然是10秒的默认值。这种文档与实际实现的不一致可能会给运维人员带来困惑。

技术影响

部署扫描器是Jetty核心的部署机制之一，负责监控webapps目录的变化并自动处理应用部署/重新部署/卸载。其扫描间隔的设置直接影响：

1. 生产环境稳定性：过短的扫描间隔可能导致不必要的资源消耗
2. 开发效率：合理的扫描间隔可以提升开发调试效率
3. 部署策略：影响CI/CD流程的设计

问题修复

项目维护者joakime在发现问题后，通过两个提交(9c8061f和639e287)修复了这个问题。主要改动包括：

1. 统一文档描述与实际代码行为
2. 确保默认配置与文档声明一致
3. 保持各版本间配置策略的连贯性

最佳实践建议

对于使用Jetty的用户，建议：

1. 显式配置scanInterval参数，不要依赖默认值
2. 生产环境建议设置为0（静态部署）以确保稳定性
3. 开发环境可根据需要设置适当的热部署间隔
4. 升级时注意检查此参数的默认值变化

这个案例也提醒我们，在使用开源中间件时，重要的配置参数应该明确指定，而不是依赖默认行为，特别是在不同版本间可能存在差异的情况下。