Mac环境下SonarQube启动报错：找不到wrapper.conf配置文件

我在Mac系统中使用SonarQube，按照官方文档要求采用jdk-11.0.16.jdk作为Java运行环境，使用PostgreSQL作为数据库服务器。已在wrapper.conf文件中配置了本机正确的Java路径，但仍弹出“configuration file, wrapper.conf: No such file or directory”错误，求排查思路。

已配置的wrapper.conf内容 #

# Path to JVM executable. By default it must be available in PATH.
# Can be an absolute path, for example:
#wrapper.java.command=%JAVA_HOME%/bin/java
wrapper.java.command=/Library/Java/JavaVirtualMachines/jdk-11.0.16.jdk/Contents/Home/bin/java

#
# DO NOT EDIT THE FOLLOWING SECTIONS
#


#********************************************************************
# Wrapper Java
#********************************************************************
wrapper.java.additional.1=-Dsonar.wrapped=true
wrapper.java.additional.2=-Djava.awt.headless=true
# extra args needed by hazelcast
wrapper.java.additional.3=--add-exports=java.base/jdk.internal.ref=ALL-UNNAMED
wrapper.java.additional.4=--add-opens=java.base/java.lang=ALL-UNNAMED
wrapper.java.additional.5=--add-opens=java.base/java.nio=ALL-UNNAMED
wrapper.java.additional.6=--add-opens=java.base/sun.nio.ch=ALL-UNNAMED
wrapper.java.additional.7=--add-opens=java.management/sun.management=ALL-UNNAMED
wrapper.java.additional.8=--add-opens=jdk.management/com.sun.management.internal=ALL-UNNAMED

wrapper.java.mainclass=org.tanukisoftware.wrapper.WrapperSimpleApp
wrapper.java.classpath.1=../../lib/sonar-application-9.5.0.56709.jar
wrapper.java.classpath.2=../../lib/jsw/wrapper-3.2.3.jar
wrapper.java.classpath.3=../../lib/sonar-shutdowner-9.5.0.56709.jar
wrapper.java.library.path.1=./lib
wrapper.app.parameter.1=org.sonar.application.App
wrapper.java.initmemory=8
wrapper.java.maxmemory=32

#********************************************************************
# Wrapper Logs
#********************************************************************

wrapper.console.format=PM
wrapper.console.loglevel=INFO
wrapper.logfile.format=M
wrapper.logfile.loglevel=INFO
wrapper.logfile.rollmode=DATE
wrapper.logfile=../../logs/sonar.YYYYMMDD.log

# Maximum size that the log file will be allowed to grow to before
#  the log is rolled. Size is specified in bytes.  The default value
#  of 0, disables log rolling.  May abbreviate with the 'k' (kb) or
#  'm' (mb) suffix.  For example: 10m = 10 megabytes.
#wrapper.logfile.maxsize=0

# Maximum number of rolled log files which will be allowed before old
#  files are deleted.  The default value of 0 implies no limit.
wrapper.logfile.maxfiles=7

# Log Level for sys/event log output.  (See docs for log levels)
wrapper.syslog.loglevel=NONE

#********************************************************************
# Wrapper Windows Properties
#********************************************************************
# Title to use when running as a console
wrapper.console.title=SonarQube

# Disallow start of multiple instances of an application at the same time on Windows
wrapper.single_invocation=true

#********************************************************************
# Wrapper Windows NT/2000/XP Service Properties
#********************************************************************
# WARNING - Do not modify any of these properties when an application
#  using this configuration file has been installed as a service.
#  Please uninstall the service before modifying this section.  The
#  service can then be reinstalled.

# Name of the service
wrapper.ntservice.name=SonarQube

# Display name of the service
wrapper.ntservice.displayname=SonarQube

# Description of the service
wrapper.ntservice.description=SonarQube

# Service dependencies.  Add dependencies as needed starting from 1
wrapper.ntservice.dependency.1=

# Mode in which the service is installed.  AUTO_START or DEMAND_START
wrapper.ntservice.starttype=AUTO_START

# Allow the service to interact with the desktop.
wrapper.ntservice.interactive=false

#********************************************************************
# Forking Properties
#********************************************************************
wrapper.disable_restarts=TRUE
wrapper.ping.timeout=0
wrapper.shutdown.timeout=0
wrapper.jvm_exit.timeout=0

排查思路 #

• 检查启动工作目录：SonarQube的wrapper脚本默认从$SONARQUBE_HOME/bin/macosx-universal-64目录读取wrapper.conf。如果在其他目录执行启动命令，会找不到配置文件，切换到该目录后执行./sonar.sh start重试。
• 验证配置文件路径：确认wrapper.conf是否在$SONARQUBE_HOME/conf目录下，脚本默认加载这个相对路径的配置。如果文件位置不对，要么移到正确目录，要么启动时用-c参数指定绝对路径，比如./sonar.sh start -c /完整路径/wrapper.conf。
• 检查文件权限：Mac下可能存在权限问题，确保运行SonarQube的用户对wrapper.conf有读取权限。执行ls -l $SONARQUBE_HOME/conf/wrapper.conf查看权限，必要时用chmod 644 $SONARQUBE_HOME/conf/wrapper.conf调整。
• 确认版本兼容性：你使用的是SonarQube 9.5，jdk11是兼容的，但要检查wrapper脚本和配置文件是否匹配，避免误替换了不同版本的wrapper.conf。
• 排查环境变量干扰：如果启动时设置了WRAPPER_CONF环境变量，可能指向错误路径。执行echo $WRAPPER_CONF查看，若有错误值，取消该环境变量后再启动。

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