docker镜像单机版启动报错

[lilinhai]

org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'consoleHealthController' defined in URL [jar:nested:/home/nacos/target/nacos-server.jar/!BOOT-INF/lib/nacos-console-3.1.0.jar!/com/alibaba/nacos/console/controller/v3/ConsoleHealthController.class]: Unsatisfied dependency expressed through constructor parameter 0: Error creating bean with name 'healthProxy' defined in URL [jar:nested:/home/nacos/target/nacos-server.jar/!BOOT-INF/lib/nacos-console-3.1.0.jar!/com/alibaba/nacos/console/proxy/HealthProxy.class]: Unsatisfied dependency expressed through constructor parameter 0: No qualifying bean of type 'com.alibaba.nacos.console.handler.HealthHandler' available: expected at least 1 bean which qualifies as autowire candidate. Dependency annotations: {}
at org.springframework.beans.factory.support.ConstructorResolver.createArgumentArray(ConstructorResolver.java:804)
at org.springframework.beans.factory.support.ConstructorResolver.autowireConstructor(ConstructorResolver.java:240)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.autowireConstructor(AbstractAutowireCapableBeanFactory.java:1395)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBeanInstance(AbstractAutowireCapableBeanFactory.java:1232)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.doCreateBean(AbstractAutowireCapableBeanFactory.java:569)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBean(AbstractAutowireCapableBeanFactory.java:529)
at org.springframework.beans.factory.support.AbstractBeanFactory.lambda$doGetBean$0(AbstractBeanFactory.java:339)
at org.springframework.beans.factory.support.DefaultSingletonBeanRegistry.getSingleton(DefaultSingletonBeanRegistry.java:373)
at org.springframework.beans.factory.support.AbstractBeanFactory.doGetBean(AbstractBeanFactory.java:337)
at org.springframework.beans.factory.support.AbstractBeanFactory.getBean(AbstractBeanFactory.java:202)
at org.springframework.beans.factory.support.DefaultListableBeanFactory.instantiateSingleton(DefaultListableBeanFactory.java:1222)
at org.springframework.beans.factory.support.DefaultListableBeanFactory.preInstantiateSingleton(DefaultListableBeanFactory.java:1188)
at org.springframework.beans.factory.support.DefaultListableBeanFactory.preInstantiateSingletons(DefaultListableBeanFactory.java:1123)
at org.springframework.context.support.AbstractApplicationContext.finishBeanFactoryInitialization(AbstractApplicationContext.java:987)
at org.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:627)
at org.springframework.boot.web.servlet.context.ServletWebServerApplicationContext.refresh(ServletWebServerApplicationContext.java:146)
at org.springframework.boot.SpringApplication.refresh(SpringApplication.java:752)
at org.springframework.boot.SpringApplication.refreshContext(SpringApplication.java:439)
at org.springframework.boot.SpringApplication.run(SpringApplication.java:318)
at org.springframework.boot.builder.SpringApplicationBuilder.run(SpringApplicationBuilder.java:149)
at com.alibaba.nacos.bootstrap.NacosBootstrap.startConsoleContext(NacosBootstrap.java:110)
at com.alibaba.nacos.bootstrap.NacosBootstrap.startWithConsole(NacosBootstrap.java:87)
at com.alibaba.nacos.bootstrap.NacosBootstrap.main(NacosBootstrap.java:54)
at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:77)
at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
at java.base/java.lang.reflect.Method.invoke(Method.java:569)
at org.springframework.boot.loader.launch.Launcher.launch(Launcher.java:102)
at org.springframework.boot.loader.launch.Launcher.launch(Launcher.java:64)
at org.springframework.boot.loader.launch.PropertiesLauncher.main(PropertiesLauncher.java:580)
Caused by: org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'healthProxy' defined in URL [jar:nested:/home/nacos/target/nacos-server.jar/!BOOT-INF/lib/nacos-console-3.1.0.jar!/com/alibaba/nacos/console/proxy/HealthProxy.class]: Unsatisfied dependency expressed through constructor parameter 0: No qualifying bean of type 'com.alibaba.nacos.console.handler.HealthHandler' available: expected at least 1 bean which qualifies as autowire candidate. Dependency annotations: {}
at org.springframework.beans.factory.support.ConstructorResolver.createArgumentArray(ConstructorResolver.java:804)
at org.springframework.beans.factory.support.ConstructorResolver.autowireConstructor(ConstructorResolver.java:240)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.autowireConstructor(AbstractAutowireCapableBeanFactory.java:1395)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBeanInstance(AbstractAutowireCapableBeanFactory.java:1232)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.doCreateBean(AbstractAutowireCapableBeanFactory.java:569)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBean(AbstractAutowireCapableBeanFactory.java:529)
at org.springframework.beans.factory.support.AbstractBeanFactory.lambda$doGetBean$0(AbstractBeanFactory.java:339)
at org.springframework.beans.factory.support.DefaultSingletonBeanRegistry.getSingleton(DefaultSingletonBeanRegistry.java:373)
at org.springframework.beans.factory.support.AbstractBeanFactory.doGetBean(AbstractBeanFactory.java:337)
at org.springframework.beans.factory.support.AbstractBeanFactory.getBean(AbstractBeanFactory.java:202)
at org.springframework.beans.factory.support.DefaultListableBeanFactory.doResolveDependency(DefaultListableBeanFactory.java:1690)
at org.springframework.beans.factory.support.DefaultListableBeanFactory.resolveDependency(DefaultListableBeanFactory.java:1635)
at org.springframework.beans.factory.support.ConstructorResolver.resolveAutowiredArgument(ConstructorResolver.java:913)
at org.springframework.beans.factory.support.ConstructorResolver.createArgumentArray(ConstructorResolver.java:791)
... 29 common frames omitted
Caused by: org.springframework.beans.factory.NoSuchBeanDefinitionException: No qualifying bean of type 'com.alibaba.nacos.console.handler.HealthHandler' available: expected at least 1 bean which qualifies as autowire candidate. Dependency annotations: {}
at org.springframework.beans.factory.support.DefaultListableBeanFactory.raiseNoMatchingBeanFound(DefaultListableBeanFactory.java:2291)
at org.springframework.beans.factory.support.DefaultListableBeanFactory.doResolveDependency(DefaultListableBeanFactory.java:1715)
at org.springframework.beans.factory.support.DefaultListableBeanFactory.resolveDependency(DefaultListableBeanFactory.java:1635)
at org.springframework.beans.factory.support.ConstructorResolver.resolveAutowiredArgument(ConstructorResolver.java:913)
at org.springframework.beans.factory.support.ConstructorResolver.createArgumentArray(ConstructorResolver.java:791)
... 42 common frames omitted
2025-09-29 18:04:24,961 ERROR Nacos failed to start, please see /home/nacos/logs/nacos.log for more details.

2025-09-29 18:04:24,972 INFO

Error starting ApplicationContext. To display the condition evaluation report re-run your application with 'debug' enabled.

2025-09-29 18:04:25,000 ERROR

---

APPLICATION FAILED TO START

---

Description:

Parameter 0 of constructor in com.alibaba.nacos.console.proxy.HealthProxy required a bean of type 'com.alibaba.nacos.console.handler.HealthHandler' that could not be found.

Action:

Consider defining a bean of type 'com.alibaba.nacos.console.handler.HealthHandler' in your configuration.

2025-09-29 18:04:30,006 INFO Get topN config from env, TopNConfig{enabled=true, topNCount=10, internalMs=0}

[KomachiSion]

我测试没有问题。

https://nacos.io/docs/latest/quickstart/quick-start-docker/?spm=5238cd80.2ef5001f.0.0.3f613b7cdMoEnC#2-%E5%90%AF%E5%8A%A8nacos

         ,--.
       ,--.'|
   ,--,:  : |                                           Nacos Console 3.1.0
,`--.'`|  ' :                       ,---.               Running in stand alone mode, All function modules
|   :  :  | |                      '   ,'\   .--.--.    Port: 8080
:   |   \ | :  ,--.--.     ,---.  /   /   | /  /    '   Pid: 1
|   : '  '; | /       \   /     \.   ; ,. :|  :  /`./   Console: http://192.168.215.2:8080/index.html
'   ' ;.    ;.--.  .-. | /    / ''   | |: :|  :  ;_
|   | | \   | \__\/: . ..    ' / '   | .; : \  \    `.      https://nacos.io
'   : |  ; .' ," .--.; |'   ; :__|   :    |  `----.   \
|   | '`--'  /  /  ,.  |'   | '.'|\   \  /  /  /`--'  /
'   : |     ;  :   .'   \   :    : `----'  '--'.     /
;   |.'     |  ,     .-./\   \  /            `--'---'
'---'        `--`---'     `----'

2025-09-30 09:46:34,496 WARN Bean 'nacosConsoleBeanPostProcessorConfiguration' of type [com.alibaba.nacos.console.config.NacosConsoleBeanPostProcessorConfiguration$$SpringCGLIB$$0] is not eligible for getting processed by all BeanPostProcessors (for example: not eligible for auto-proxying). The currently created BeanPostProcessor [nacosDuplicateSpringBeanPostProcessor] is declared through a non-static factory method on that class; consider declaring it as static instead.

2025-09-30 09:46:34,510 INFO Tomcat initialized with port 8080 (http)

2025-09-30 09:46:34,513 INFO Root WebApplicationContext: initialization completed in 185 ms

2025-09-30 09:46:34,552 INFO Adding welcome page: class path resource [static/index.html]

2025-09-30 09:46:34,608 INFO Exposing 1 endpoint beneath base path '/actuator'

2025-09-30 09:46:34,614 INFO Tomcat started on port 8080 (http) with context path '/'

2025-09-30 09:46:34,619 INFO Nacos Console started successfully in 305 ms

[herodotus-ecosystem]

估计是版本错了，3.1.0 刚发的是 Release 版本，后面又发了一个 3.1.0-bugfix 版本。

抛错问题怕是和 nacos.deployment.type=merged 配置有关。我自己尝试打包，参考其它人的 PR 把 application.properties 中的 nacos.deployment.type=merged 配置删了，就会出现同样的错误。

和 ISSUE #13847 应该是同一个问题

参见：#474

一、矛盾点分析（用户和开发的差异点）

目前看矛盾点主要来自于几方面

1. nacos.deployment.type 有默认值问题

目前看，文档中说，nacos.deployment.type 有默认值。但是从启动脚本上看，其实是没有默认值的，如果 application.properties 中有 nacos.deployment.type=merged 配置，就会帮助设置默认值

可能实际的 properties 中， nacos.deployment.type 有默认值，会不会因为没有手动设置 NACOS_DEPLOYMENT_TYPE 环境变量，导致 nacos.deployment.type 实际值就为空了。没有具体看代码，仅是猜测。

启动脚本

if [[ ! -z "${NACOS_DEPLOYMENT_TYPE}" ]]; then
  JAVA_OPT="${JAVA_OPT} -Dnacos.deployment.type=${NACOS_DEPLOYMENT_TYPE}"
fi

属性配置列表

属性名称	描述	选项
NACOS_DEPLOYMENT_TYPE	nacos.deployment.type	default : merged 支持配置 server console

2. nacos example docker compose 问题

在 Nacos Docker 的 Docker Compose 中，其实所有示例都是手动设置了 NACOS_DEPLOYMENT_TYPE。如果是经常使用 Nacos Docker 的用户，特别是从低版本一直使用过来的，就会忽略这个参数。

但是根据 docker-startup.sh 看，NACOS_DEPLOYMENT_TYPE 是可选参数，并没有强制要求设置。

version: "3.8"
services:
  nacos-console:
    image: nacos/nacos-server:${NACOS_VERSION}
    container_name: nacos-standalone-console
    environment:
      - NACOS_DEPLOYMENT_TYPE=console
    env_file:
      - ../env/nacos-standalone-mysql.env
    volumes:
      - ./standalone-console-logs/:/home/nacos/logs
      - ./cluster.conf:/home/nacos/conf/cluster.conf
    ports:
      - "8080:8080"
    restart: always
  nacos-server:
    image: nacos/nacos-server:${NACOS_VERSION}
    container_name: nacos-standalone-server
    environment:
      - NACOS_DEPLOYMENT_TYPE=server
    env_file:
      - ../env/nacos-standalone-mysql.env
    volumes:
      - ./standalone-server-logs/:/home/nacos/logs
    ports:
      - "8848:8848"
      - "9848:9848"
    depends_on:
      mysql:
        condition: service_healthy
    restart: always

二、总结

总结下来，应该是开发测试因为始终设置了 NACOS_DEPLOYMENT_TYPE 所以不会有问题。用户在用新版本时，把 NACOS_DEPLOYMENT_TYPE 当成可选参数，没有设置。 docker-startup.sh 中也并未提示必须要设置 NACOS_DEPLOYMENT_TYPE

所以 application.properties 中 nacos.deployment.type 配置，变成了保底措施。没有删除时，能保证 nacos.deployment.type 最终启动之后有默认值，删除之后不手动设置环境变量 NACOS_DEPLOYMENT_TYPE 就会抛错。

@KomachiSion

[lilinhai]

我复制的官方docker启动脚本，没有加参数-e NACOS_DEPLOYMENT_TYPE=merged的，启动就报上述错，加了就没问题了，但是官方文档脚本也没加该参数啊！！
docker run --name nacos-standalone-pg
--network host
-v "/data/docker-containers/nacos-server/conf:/home/nacos/conf"
-v "/data/docker-containers/nacos-server/logs:/home/nacos/logs"
-v "/data/docker-containers/nacos-server/data:/home/nacos/data"
-v "/data/docker-containers/nacos-server/plugins:/home/nacos/plugins"
-e MODE=standalone
-e NACOS_AUTH_ENABLE=true
-e NACOS_AUTH_TOKEN=wjKVgujg0+AF/NwEXuQKigQBcwF6mlrcMqsfw5b5mG4=
-e NACOS_AUTH_IDENTITY_KEY=NFJGnbMdx4w6S7veTMpLk97fOJm5VBfd
-e NACOS_AUTH_IDENTITY_VALUE=n43BTYT9WaSewV1PzIidBWOwIr5OUGu0Kc8boHnFExJgA4O0499srJGjjWgSoKnE
-e JVM_XMS=512M
-e JVM_XMX=1024M
-p 8080:8080
-p 8848:8848
-p 9848:9848
-d registry.cn-hangzhou.aliyuncs.com/sinhy/nacos-server:v3.1.0

[KomachiSion]

估计是版本错了，3.1.0 刚发的是 Release 版本，后面又发了一个 3.1.0-bugfix 版本。

抛错问题怕是和 nacos.deployment.type=merged 配置有关。我自己尝试打包，参考其它人的 PR 把 application.properties 中的 nacos.deployment.type=merged 配置删了，就会出现同样的错误。

和 ISSUE #13847 应该是同一个问题

参见：#474

一、矛盾点分析（用户和开发的差异点）

目前看矛盾点主要来自于几方面

1. nacos.deployment.type 有默认值问题

目前看，文档中说，nacos.deployment.type 有默认值。但是从启动脚本上看，其实是没有默认值的，如果 application.properties 中有 nacos.deployment.type=merged 配置，就会帮助设置默认值

可能实际的 properties 中， nacos.deployment.type 有默认值，会不会因为没有手动设置 NACOS_DEPLOYMENT_TYPE 环境变量，导致 nacos.deployment.type 实际值就为空了。没有具体看代码，仅是猜测。

启动脚本

if [[ ! -z "${NACOS_DEPLOYMENT_TYPE}" ]]; then
JAVA_OPT="${JAVA_OPT} -Dnacos.deployment.type=${NACOS_DEPLOYMENT_TYPE}"
fi

属性配置列表

属性名称 描述 选项
NACOS_DEPLOYMENT_TYPE nacos.deployment.type default : merged 支持配置 server console

2. nacos example docker compose 问题

在 Nacos Docker 的 Docker Compose 中，其实所有示例都是手动设置了 NACOS_DEPLOYMENT_TYPE。如果是经常使用 Nacos Docker 的用户，特别是从低版本一直使用过来的，就会忽略这个参数。

但是根据 docker-startup.sh 看，NACOS_DEPLOYMENT_TYPE 是可选参数，并没有强制要求设置。

version: "3.8"
services:
nacos-console:
image: nacos/nacos-server:${NACOS_VERSION}
container_name: nacos-standalone-console
environment:
- NACOS_DEPLOYMENT_TYPE=console
env_file:
- ../env/nacos-standalone-mysql.env
volumes:
- ./standalone-console-logs/:/home/nacos/logs
- ./cluster.conf:/home/nacos/conf/cluster.conf
ports:
- "8080:8080"
restart: always
nacos-server:
image: nacos/nacos-server:${NACOS_VERSION}
container_name: nacos-standalone-server
environment:
- NACOS_DEPLOYMENT_TYPE=server
env_file:
- ../env/nacos-standalone-mysql.env
volumes:
- ./standalone-server-logs/:/home/nacos/logs
ports:
- "8848:8848"
- "9848:9848"
depends_on:
mysql:
condition: service_healthy
restart: always

二、总结

总结下来，应该是开发测试因为始终设置了 NACOS_DEPLOYMENT_TYPE 所以不会有问题。用户在用新版本时，把 NACOS_DEPLOYMENT_TYPE 当成可选参数，没有设置。 docker-startup.sh 中也并未提示必须要设置 NACOS_DEPLOYMENT_TYPE

所以 application.properties 中 nacos.deployment.type 配置，变成了保底措施。没有删除时，能保证 nacos.deployment.type 最终启动之后有默认值，删除之后不手动设置环境变量 NACOS_DEPLOYMENT_TYPE 就会抛错。

@KomachiSion

hotfix 修复了两个问题：

1. window的启动脚本中nacos.deployment.type的参数名错误，导致会使用window启动脚本时出现上述错误， 在linux脚本中无此问题。
2. 适配了916版本的mcp 官方registry协议。

nacos官方镜像中使用的是linux脚本， 在不输出NACOS_DEPLOYMENT_TYPE时，使用的是默认值merged，因此不会有问题。
同时我实际测试下来，官方镜像并不会出现无法启动的问题。

[KomachiSion]

我复制的官方docker启动脚本，没有加参数-e NACOS_DEPLOYMENT_TYPE=merged的，启动就报上述错，加了就没问题了，但是官方文档脚本也没加该参数啊！！ docker run --name nacos-standalone-pg --network host -v "/data/docker-containers/nacos-server/conf:/home/nacos/conf" -v "/data/docker-containers/nacos-server/logs:/home/nacos/logs" -v "/data/docker-containers/nacos-server/data:/home/nacos/data" -v "/data/docker-containers/nacos-server/plugins:/home/nacos/plugins" -e MODE=standalone -e NACOS_AUTH_ENABLE=true -e NACOS_AUTH_TOKEN=wjKVgujg0+AF/NwEXuQKigQBcwF6mlrcMqsfw5b5mG4= -e NACOS_AUTH_IDENTITY_KEY=NFJGnbMdx4w6S7veTMpLk97fOJm5VBfd -e NACOS_AUTH_IDENTITY_VALUE=n43BTYT9WaSewV1PzIidBWOwIr5OUGu0Kc8boHnFExJgA4O0499srJGjjWgSoKnE -e JVM_XMS=512M -e JVM_XMX=1024M -p 8080:8080 -p 8848:8848 -p 9848:9848 -d registry.cn-hangzhou.aliyuncs.com/sinhy/nacos-server:v3.1.0

你使用的不是官方的仓库，我不清楚这是否是你自行同步的或者是其他人维护的私有镜像， 若是不加NACOS_DEPLOYMENT_TYPE=merged无法启动，请联系此镜像的提供者维护。

[KomachiSion]

PR中的修复方式可作为 源码启动的优化项进行合并， 但是对于使用官方镜像启动或官方脚本启动的用户影响不大。

[KomachiSion]

我仔细看了一下， 知道了问题。

1.官方镜像中的application.properties中有设置nacos.deployment.type，因此可以启动
2.官方部署包中的startup.sh和startup.cmd中也有设置nacos.deployment.type的默认值，因此可以启动（hotfix前startup.cmd脚本中的nacos.deployment.type名字拼写错误导致问题，重新下载即可）

因此我的环境中怎么操作都无法复现。

该issue的author 可能是用了官方进行进行了二次修改，复制了自定义的application.properties作为启动配置文件，但此文件中没有对应的nacos.deployment.type， 导致缺少了这个必选配置。

目前对于二次开发镜像，社区是无法帮助维护的，所以需要自行添加对应参数到启动脚本中或者添加环境变量使用。

PR所提交的优化可以帮助减少其他二次修改镜像中出现此问题的可能。

[lilinhai]

我澄清下，以下脚本，这个是官方的nacos原版镜像，只是国内无法下载，我通过github上传到阿里云私有仓库的。
看到你的回复，我找到问题的根因了，因为我是把镜像里面的配置目录“/home/nacos/conf”挂载到宿主机下的，而宿主机下的conf配置文件的来源是从同版本的安装包“nacos-server-3.1.0.zip”里拷贝过去的，这个安装包里面的application.properties配置文件中确实没有默认的nacos.deployment.type配置，因此导致docker镜像无法成功启动！这就是该问题的根因，如果conf目录不映射到宿主机是没有问题的！请详查！

docker run --name nacos-standalone-pg
--network host
-v "/data/docker-containers/nacos-server/conf:/home/nacos/conf"
-v "/data/docker-containers/nacos-server/logs:/home/nacos/logs"
-v "/data/docker-containers/nacos-server/data:/home/nacos/data"
-v "/data/docker-containers/nacos-server/plugins:/home/nacos/plugins"
-e NACOS_DEPLOYMENT_TYPE=merged
-e MODE=standalone
-e NACOS_AUTH_ENABLE=true
-e NACOS_AUTH_TOKEN=wjKVgujg0+AF/NwEXuQKigQBcwF6mlrcMqsfw5b5mG4=
-e NACOS_AUTH_IDENTITY_KEY=NFJGnbMdx4w6S7veTMpLk97fOJm5VBfd
-e NACOS_AUTH_IDENTITY_VALUE=n43BTYT9WaSewV1PzIidBWOwIr5OUGu0Kc8boHnFExJgA4O0499srJGjjWgSoKnE
-e JVM_XMS=512M
-e JVM_XMX=1024M
-p 8080:8080
-p 8848:8848
-p 9848:9848
-d registry.cn-hangzhou.aliyuncs.com/sinhy/nacos-server:v3.1.0