Windows下Apache NetBeans 19无法启停Apache Tomcat 10服务器

环境配置步骤 #

• 通过安装程序在Windows上安装Apache NetBeans 19
• 通过安装程序在Windows上安装Apache Tomcat 10
• 在Apache NetBeans 19中添加上述Tomcat 10服务器

异常现象 #

Apache NetBeans 19可正常识别Apache Tomcat 10的Catalina Home目录内容，但右键点击服务器执行启停操作时，始终超时无法生效。两者均为默认安装，推测遗漏了某一未被充分文档化的配置步骤。

以下是几个最可能被遗漏的配置点，按排查优先级排序：

1. 停止Tomcat的Windows服务（若已安装） #

默认安装Tomcat时，安装向导会询问是否将其注册为Windows系统服务。如果选择了该项，Tomcat会在系统启动时自动运行，此时NetBeans的启停命令会因为端口被占用或无法控制服务进程而超时。

• 按下Win+R输入services.msc打开服务管理器
• 找到名称为Apache Tomcat 10.x的服务，右键选择“停止”
• 回到NetBeans重新尝试启停操作

2. 配置Tomcat管理用户权限 #

NetBeans需要通过Tomcat的管理接口来控制启停，默认的tomcat-users.xml没有配置具备对应权限的用户，导致无法完成校验。

• 打开Tomcat安装目录下的conf/tomcat-users.xml文件
• 在<tomcat-users>标签内部添加如下配置（可自行修改用户名和密码）：

  <user username="nbadmin" password="nbadmin123" roles="manager-gui,admin-gui,manager-script"/>
  

• 保存文件后，打开NetBeans的Tomcat服务器配置界面，切换到“连接”选项卡，填入刚才设置的用户名和密码
• 重启NetBeans后重试启停操作

3. 以管理员身份运行NetBeans #

Windows系统下，Tomcat默认安装在Program Files目录，普通权限的NetBeans可能没有足够的读写/执行权限来操作Tomcat的启动脚本或日志文件，导致启停超时。

• 右键NetBeans的桌面快捷方式，选择“以管理员身份运行”
• 打开项目后重新尝试服务器启停

4. 检查端口占用情况 #

Tomcat的SHUTDOWN端口（默认8005）或HTTP端口（默认8080）被其他程序占用，会导致NetBeans无法正常连接或启动Tomcat。

• 按下Win+R输入cmd打开命令提示符
• 执行命令netstat -ano | findstr :8005，查看是否有进程占用该端口
• 如果有，记下PID后打开任务管理器，找到对应PID的进程并关闭
• 同样检查8080端口，确认无占用后重试

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