Coldbox route-visualizer安装成功后无法在浏览器显示怎么办？

• 确认模块注册状态

  • 检查项目根目录的box.json，查看devDependencies节点是否包含route-visualizer，确保--savedev参数生效。
  • 验证modules目录下是否存在完整的route-visualizer文件夹，若文件缺失，重新执行install route-visualizer --savedev。

• 检查Coldbox模块加载配置

  • 打开config/Coldbox.cfc，确认modules配置中是否正确加载开发模块。若自定义了模块加载逻辑，手动添加：

    modules = [
        // 其他已加载模块
        { name = "route-visualizer", developmentOnly = true }
    ];
    

  • 确保当前运行环境为开发环境，可通过设置环境变量CF_ENV=development启动服务器，因为--savedev安装的模块默认仅在开发环境加载。

• 强制重新初始化模块

  • 执行带强制清理参数的重新初始化命令，确保模块完全重载：

    coldbox reinit force
    

• 验证访问路径

  • 尝试添加modules前缀访问：127.0.0.1:42518/modules/route-visualizer
  • 查看route-visualizer模块下的ModuleConfig.cfc，检查routes节点定义的实际访问路径，确保未被项目自定义路由覆盖。

• 排查日志信息

  • 查看Commandbox服务器日志或Coldbox应用日志，定位是否存在模块加载失败的报错（如依赖缺失、权限问题等）。

内容的提问来源于stack exchange，提问作者Cmaso