使用NSSM安装Keycloak为Windows服务启动失败问题排查

核心错误点 #

1. 服务名大小写不匹配：你在设置AppParameters时使用了小写的keycloak，但之前安装服务时用的是大写开头的"Keycloak"，NSSM对服务名大小写敏感，导致启动参数未正确绑定到目标服务。
2. 批处理执行环境问题：Windows服务环境下直接调用kc.bat可能无法正确加载CMD的系统环境变量，导致批处理执行失败。
3. 可执行路径显示误解：NSSM本身就是服务的宿主程序，服务列表中显示可执行路径为nssm.exe是正常现象，它会托管你配置的目标程序（kc.bat）运行，这点无需担心。

修正后的操作步骤 #

1. 先卸载现有错误配置的服务

nssm.exe remove "Keycloak" confirm

2. 重新安装并配置服务

通过cmd.exe托管执行批处理，确保环境变量正常加载：

# 安装服务，指定cmd.exe作为执行载体
nssm.exe install "Keycloak" "C:\Windows\System32\cmd.exe"
# 设置工作目录为Keycloak的bin目录（去掉末尾反斜杠避免解析问题）
nssm.exe set "Keycloak" AppDirectory "C:\Keycloak\keycloak-24.0.2\bin"
# 设置服务描述
nssm.exe set "Keycloak" Description "Keycloak Identity and Access Management"
# 设置执行参数：/c 表示执行后关闭CMD窗口，后跟完整的批处理命令
nssm.exe set "Keycloak" AppParameters "/c kc.bat start-dev"
# 可选：设置服务为自动启动
nssm.exe set "Keycloak" Start SERVICE_AUTO_START

3. 启动并验证服务

nssm.exe start "Keycloak"

额外排查建议 #

• 运行nssm.exe edit "Keycloak"打开NSSM图形配置界面，检查所有配置项是否与上述命令一致，重点确认Application标签页的路径和参数。
• 查看NSSM日志（默认路径为C:\Program Files\nssm\Logs），如果启动失败，日志会记录具体的错误信息。
• 确保服务运行账号拥有Keycloak目录的读写权限，必要时在NSSM配置中切换为本地系统账号（Local System）测试。

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