Webman热更新失效主因是Monitor进程未启用或配置错误，需检查process.php注册、Monitor.php路径监听、opcache设置、文件系统权限及容器挂载选项。
Webman 默认不带热更新能力，所谓“热更新失效”其实是开发时没启用文件监控机制，或者监控被缓存、权限、配置干扰导致修改后不自动 reload。核心问题不是 HMR（Webpack 那套），而是 Webman 自身的 Monitor 进程是否正常工作、是否监听了正确的路径、是否被 opcache 或文件系统特性绕过。
Monitor 进程是否启用且配置正确
Webman 的热重载依赖 app/process/Monitor.php 这个进程文件，它通过 inotify（Linux/macOS）或轮询（Windows）监听代码变更并触发 reload。若该进程未注册或配置错误，修改文件就完全静默。
- 检查
config/process.php中是否已启用 Monitor：确认'monitor' => \app\process\Monitor::class存在且未被注释 - 确认
app/process/Monitor.php文件存在，且类中$command属性为'php start.php reload'（不是restart） - Mac 用户特别注意：若使用 APFS 加密卷或 Time Machine 备份目录，inotify 可能失效，需强制启用轮询模式 —— 在
Monitor.php的options数组中设'enable_inotify' => false, 'polling' => true
opcache 导致文件内容未刷新
PHP 的 opcache 会缓存已编译的脚本字节码，即使文件磁盘内容变了，Worker 进程仍执行旧 opcode，表现为“改了代码但没生效”，且无任何报错。
Webman 2.2.0版本强化了 TCP/UDP 服务支持，优化路由组管理，并增强异步任务处理能力。结合协程与连接池技术，Webman 能轻松应对高并发场景，适用于网站、接口服务、即时通讯、物联网及游戏开发，兼具高性能、灵活扩展与稳定可靠，是多场景 PHP 服务开发的理想选择。
- 临时禁用 opcache：编辑
php.ini，注释掉zend_extension=opcache及所有opcache.*行，然后php -m | grep opcache确认无输出 - 开发环境更稳妥的做法是保留 opcache 但关闭脚本缓存：设
opcache.enable_cli=0和opcache.validate_timestamps=1（默认开启），避免 CLI 模式下误命中缓存 - 不要依赖
opcache_reset()—— Webman 多进程下只对当前 Worker 生效，其他进程仍跑旧代码
文件监听路径遗漏或大小写不一致
Monitor 默认只监听 app/、config/、route.php 等固定路径。如果你把控制器放在 src/、中间件放在 plugin/xxx/middleware，或用了自定义目录结构，这些路径不会被自动监控。
- 在
app/process/Monitor.php的$watchPaths属性中手动追加路径，例如：['src/', 'plugin/', 'public/'] - Linux/macOS 下路径区分大小写，
import './Components/Button.vue'但实际目录是components/，会导致变更不触发 —— 监控器按字符串匹配路径，不作 normalize - 避免将项目放在 Dropbox、iCloud Drive 或 WSL2 的 Windows 挂载路径下，这些场景 inotify 事件常丢失或延迟数分钟
权限与 runtime 目录干扰
Monitor 进程需要读取文件 mtime 并写入 runtime/monitor.pid，若目录不可写或 inode 被锁定，监听会静默失败。
- 运行
ls -ld runtime/，确认当前启动 Webman 的用户（如www-data）对该目录有rwx权限 - 检查
runtime/monitor.pid是否存在且内容为有效 PID；若文件为空或被其他进程占用，Monitor会跳过初始化 - 某些容器环境（如 Docker）挂载 volume 时未设置
cached或delegated选项，会导致 inotify 事件无法透传到容器内 —— 此时必须启用轮询（polling => true）
真正卡住的地方往往不是配置开关，而是 Monitor 进程根本没跑起来，或者它监听的路径和你改的文件根本不在一个维度上。先用 php start.php status 看 Monitor 是否在列表里，再查 runtime/log/monitor.log 有没有 “watch path not exist” 类警告 —— 这比猜 opcache 或网络问题快得多。
