AI 助理
备案控制台
文档
输入文档关键字查找
首页 企业级分布式应用服务 开发参考 开发者指南 开发者指南常见问题 应用开发 HSF错误码 错误编码：HSF-0001

错误编码：HSF-0001

更新时间：
产品详情
我的收藏

报错信息

HSFServiceAddressNotFoundException 未找到需要调用的服务目标地址。

描述信息

需要调用的目标服务为：xxxx； 组别为：xxxx。

基本问题排查

  1. 服务本身的发布、调用是否正确。

    • 验证服务是否发布：在对应环境（日常、预发或线上环境）的微服务治理控制台查询需要的服务。

    • 名称不匹配，检查代码中对应发布者和消费者XML配置的interface、version、group，3个数据要完全一致（注意大小写也要一样， 同时要注意前后不能有空格）。

  2. 检查服务提供者防火墙是否开启或网络不通，即telnet服务提供者IP HSF端口（默认12200）是否可以正常连接。如果不能正常连接说明防火墙开启或网络存在问题，需要协调相关负责人员排查。

  3. 是否存在多网卡，如果存在多网卡可以使用-Dhsf.server.ip指定服务端的IP。

    • 本地开发环境可以直接设定JVM启动参数。

    • 生产环境需要跟开发联系确定如何解决。

  4. 检查是否因服务调用太快，在ConfigServer将地址推送过来之前就发起调用导致出错。在服务消费者的配置项里添加 maxWaitTimeForCsAddress 的相关配置，请参见开发服务消费者。

本地开发环境排查

本地使用轻量配置中心进行开发时，服务发布、订阅均无需鉴权，故服务正常启动就可以注册、订阅成功。在排除掉前面的基本问题后，可以按照如下步骤进行排查。

  1. 轻量配置中心检查。

    1. 登录轻量配置中心控制台，搜索对应的服务，检查服务是否已经发布成功，以及服务提供者的IP、端口是否正确。如果服务未发布成功，请执行步骤2排查原因。

    2. 搜索对应的服务，检查服务是否已经订阅成功。如果服务未订阅成功，请执行步骤3 进行排查。

    3. 检查订阅者机器上Telnet服务提供者的IP端口，是否可以正常联通。

  2. 服务提供者排查。

    如果轻量配置中心控制台发现服务未能发布成功，请进行如下排查。

    1. 执行ping jmenv.tbsite.net命令，确定地址服务器IP跟轻量配置中心IP是否一致。

    2. 清空/{userhome}/logs/下所有日志，清空/{userhome}/configclient/目录。

    3. 启动服务提供者应用。如果之前Tomcat已经启动，请重启。

    4. 查看Tomcat启动日志。

      • 如果无异常信息，回显信息中会显示启动耗时，单位ms。

      • 如果有异常，请解决异常。

    5. 查看/{userhome}/configclient/logs/configclient.log或/{userhome}/logs/configclient/configclient.log（不同版本稍有区别），查找Connecting to remoting://{IP 地址}连接的注册中心IP与轻量配置中心IP是否一致。如果不一致，请确认轻量配置中心是否通过-Daddress.server.ip={可以访问的 IP}调整过IP。

    6. 对应服务[Register-ok][Publish-ok]，确定服务名、版本、分组都是预期的信息。

    7. 如果显示[Register-ok][Publish-ok]，说明服务提供者正常注册到服务注册中心。开发环境只要启动成功就可以注册成功。

    说明

    在实际开发过程中机器上可能会同时启动多个服务提供者，例如A，B，C；每个服务提供者对外提供的HSF端口会在12200基础上依次累加。同时可以通过在JVM参数上指定IP和端口：-Dhsf.server.ip=<ip> -Dhsf.server.port=<port> 。在轻量配置中心上可以检查服务端端口与实际启动的端口是否一致，不一致会导致消费端调用失败，可以通过轻量配置中心控制台更新服务端端口，或者删除掉服务，重新发布应用。

  3. 服务消费者排查。

    1. 执行ping jmenv.tbsite.net命令，确定地址服务器IP跟轻量配置中心IP一致。

    2. 启动服务消费者应用，如果之前Tomcat已经启动，请重启。

    3. 查看Tomcat启动日志。

      • 如果无异常信息，回显信息中会显示启动耗时，单位ms。

      • 如果有异常，请解决异常。

    4. 查看 /{userhome}/configclient/logs/configclient.log 或 /{userhome}/logs/configclient/configclient.log（不同版本稍有区别），查找 Connecting to remoting://{IP 地址}连接的注册中心IP跟轻量配置中心IP一致，如果不一致，请确认轻量配置中心是否通过 -Daddress.server.ip={可以访问的 IP}调整过IP。

    5. 查看日志中对应的服务订阅情况，[Data-received] 是否收到服务提供者的具体信息。如果未收到服务提供者数据，需要确定服务提供者服务已经注册成功。

    6. 检查订阅者机器上Telnet服务提供者的IP端口，是否可以正常联通。如果不能正常连接说明防火墙开启或网络存在问题，需要协调相关负责人员排查。

线上环境排查

使用EDAS管理和部署的应用都是使用的正式环境，正式环境存在严格的服务鉴权和数据隔离。由于存在鉴权，正式环境不同主账号之间的服务无法直接互相调用，同时开发环境也无法调用访问正式环境的服务。

  1. 服务提供者排查。

    1. 查看id="codeph_hor_1ki****">cat /home/admin/{taobao-tomcat 目录}/bin/setenv.sh该文件中 -Daddress.server.domain={地址服务器域名}对应地址服务器域名。

    2. 执行ping {地址服务器域名}命令，查看返回的IP是否正常。如果不能ping通，说明网络存在问题，请排查网络。

    3. 清空/home/admin/logs/下所有日志、/home/admin/configclient/目录和/home/admin/{taobao-tomcat 目录}/logs/目录。

    4. 启动服务提供者应用。如果之前 Tomcat 已经启动，请重启。

    5. 查看/home/admin/{taobao-tomcat 目录}/logs/catalina.out。

      • 如果无异常信息，该文件最后显示启动耗时，单位ms。

      • 如果有异常，请解决异常。

    6. 查看/home/admin/{taobao-tomcat 目录}/logs/localhost-{日期}.log该文件是否有异常信息。如果有异常，请解决异常。

    7. 查看/home/admin/configclient/logs/configclient.log 或/home/admin/logs/configclient/configclient.log（不同版本稍有区别），对应服务[Register-ok][Publish-ok]，确定服务名、版本、分组是否为预期信息。如果显示[Publish or unregister error]，请排查。

      查看catalina.out日志中edas.hsf.xxxx格式的版本。

      1. 低于edas.hsf.2114.1.0，您必须创建对应服务分组，否则会鉴权失败。登录EDAS控制台，在左侧导航栏，选择流量管理 > 微服务治理 > HSF > 服务分组，查看应用的服务分组是否已经创建。

      2. 大于或等于edas.hsf.2114.1.0，EDAS已提供多租户方式隔离，不需要创建服务分组。对应服务会注册2次，一次是基于租户注册（总是成功），一次是基于分组注册（可能失败，但不影响服务调用）。 

        2018-07-19 10:28:44.716|ERROR|[] [] [%s] [Publish or unregister error] spas-authentication-failed! dataId:com.alibaba.edas.testcase.api.TestCase:1.0.0 group:test error:java.lang.Error: A receivedRevision:2 tenant:DEFAULT_TENANT
2018-07-19 10:28:44.717|INFO|[] [] [] [Register-ok] Publisher (HSFProvider-com.alibaba.edas.testcase.api.TestCase:1.0.0.2 for com.alibaba.edas.testcase.api.TestCase:1.0.0)Tenant:0846c173-decf-4b47-xxxxxxxx in group test in env default
2018-07-19 10:28:44.717|INFO|[] [] [] [Publish-ok] dataId=com.alibaba.edas.testcase.api.TestCase:1.0.0, clientId=HSFProvider-com.alibaba.edas.testcase.api.TestCase:1.0.0.2, datumId=ecu:ed5b9d2b-a276-4ad7-b7b9-14e432ff****:192.168.xx.xx,tenant=0846c173-decf-4b47-xxxxxxxx, rev=2, env=default

        上述ERROR级别日志中：使用tenant:DEFAULT_TENANT鉴权失败；使用tenant=0846c173-decf-4b47-xxxxxxxx发布成功。只需保证两套鉴权成功一次即可。

      3. 返回信息中提示[Register-ok][Publish-ok]，说明服务提供者正常注册到服务注册中心。

  2. 服务消费者排查。

    1. 执行cat /home/admin/{taobao-tomcat 目录}/bin/setenv.sh命令，查看文件中-Daddress.server.domain={地址服务器域名}对应地址服务器域名。

    2. 执行ping {地址服务器域名}命令，查看返回的IP是否正常。如果不能ping通，说明网络存在问题，请排查网络。

    3. 清空 /home/admin/logs/下所有日志、 /home/admin/configclient/目录以及 /home/admin/{taobao-tomcat 目录}/logs/目录。

    4. 启动服务消费者应用，如果之前Tomcat已经启动，请重启。

    5. 查看/home/admin/{taobao-tomcat 目录}/logs/catalina.out文件。

      • 如果无异常信息，该文件最后显示启动耗时，单位ms。

      • 如果有异常，请解决异常。

    6. 查看 /home/admin/{taobao-tomcat 目录}/logs/localhost-{日期}.log文件中是否有异常信息。如果有异常，请解决异常。

    7. 查看 /home/admin/configclient/logs/configclient.log 或 /home/admin/logs/configclient/configclient.log（不同版本稍有区别）日志中对应的服务订阅情况。在日志中，搜索对应服务，查看返回信息中[Data-received]字段，是否收到服务提供者的具体信息。如果未收到服务提供者数据，需要确定服务提供者服务是否已经注册成功。

    8. 检查订阅者机器上Telnet服务提供者的IP端口，是否可以正常联通。如果不能正常连接，说明防火墙开启或网络存在问题，需要协调相关负责人员排查。

    9. 相关日志排查。

      1. 查看/home/admin/configclient/snapshot/DEFAULT_ENV/文件中，消费端服务订阅到的实际服务列表数据信息如下： 

        [root@iZ2ze26awga24ijh93152dZ com.alibaba.edas.carshop.itemcenter.ItemService:1.0.0]# cat HSF-0846c173-decf-4b47-8aa0-xxxxxx.dat
                                [
                                "192.168.xx.xx:12200?_p\u003dhessian2\u0026_ENV\u003dDEFAULT\u0026v\u003d2.0\u0026_TIMEOUT\u003d3000\u0026_ih2\u003dy\u0026_TID\u003d0846c173-decf-4b47-8aa0-04b5a561****\u0026_SERIALIZETYPE\u003dhessian\u0026_auth\u003dy"
                                ]

      2. 查看/home/admin/logs/hsf/hsf.log文件中服务调用报错信息。

      3. 查看/home/admin/logs/hsf/hsf-remoting.log记录的消费端与服务端心跳检查日志，若出现如下日志： 

        01 2018-06-20 12:35:00.797 ERROR [HSF-Worker-2-thread-1:hsf.remoting] [] [] [HSF-0085] [remoting] fail to connect: /192.168.xx.xx:12200 in timeout: 4000

        该日志为消费端与提供端无法建立TCP长连接。

        1. 检查对应的机器IP上的服务正常启动，对应的端口是否已经处于监听状态（例如12200）。

        2. 否则，可以尝试检查消费端telnet服务端IP Port的端口是否未开放。

上一篇：HSF错误码下一篇：错误编码：HSF-0002
文档推荐