SOFA加好友失败怎么解决？常见问题与解决方法

应依次检查ReadinessCheck健康状态、RPC服务注册与发现、好友服务Bean初始化、配置属性解析及客户端与服务端Endpoint一致性，确保各环节正常。

如果您尝试在SOFABoot应用中通过社交化功能模块（如集成IM或用户关系服务）添加好友，但操作失败并返回错误提示，则可能是由于服务依赖未就绪、健康检查未通过或RPC调用地址缺失所致。以下是解决此问题的步骤：

一、验证ReadinessCheck健康状态

SOFABoot应用需通过/actuator/readiness端点确认所有组件已就绪，若该端点返回非UP状态，则好友添加请求将被拦截或拒绝。健康检查聚合逻辑由ReadinessEndpoint.java实现，依赖各HealthIndicator的执行结果。

1、访问/actuator/readiness?showDetail=true端点，获取详细健康信息。

2、检查响应中是否包含"sofaFriendService": {"status": "UP"}条目。

3、若状态为DOWN或UNKNOWN，定位对应HealthIndicator实现类，核查其内部依赖（如数据库连接、RPC服务引用）是否可用。

二、检查RPC服务注册与发现状态

好友添加功能通常依赖RPC远程调用用户中心或关系服务，若服务地址未成功推送至客户端，将导致“RPC-02306：没有获得服务的调用地址”错误。服务地址推送由SOFA Registry完成，日志位于/home/admin/logs/rpc/sofa-registry.log。

1、在客户端日志中搜索服务接口全限定名，例如com.alipay.sofa.friend.api.FriendService。

2、确认日志中是否存在可调用目标地址[1]个记录；若为[0]个，说明服务未注册或网络隔离。

3、登录SOFA应用中心，核实该服务在对应zone下是否显示为已注册且实例数大于0。

三、确认好友服务Bean初始化成功

好友功能相关Bean（如FriendManager、RelationshipProcessor）若因依赖缺失或循环引用导致初始化失败，将抛出BeanCreationException，进而使整个功能链路不可用。StartupReporterBeanPostProcessor可追踪此类初始化过程。

1、查看启动日志中是否出现Caused by: org.springframework.beans.factory.BeanCreationException堆栈。

2、定位异常中提及的Bean名称，检查其@DependsOn声明或构造函数注入的依赖项是否已加载。

3、启用启动报告：在application.properties中添加sofa.boot.startup.report.enabled=true，重启后分析startup-report.html输出。

四、排查配置属性解析异常

好友功能常需读取动态配置（如白名单开关、加好友频率限制），若application.yml中占位符${friend.allow.add}引用的属性未定义或文件编码为GBK而非UTF-8，会导致PropertyPlaceholderConfigurer解析失败，相关功能默认关闭。

1、检查配置文件路径是否为src/main/resources/application.yml，确认无拼写错误或路径错位。

2、搜索配置项关键字，验证其值是否符合预期格式（如布尔值应为true而非"true"字符串）。

3、在日志中检索Could not resolve placeholder，定位未定义属性并补全或设置默认值。

五、校验客户端与服务端Endpoint一致性

若SOFA好友模块采用AntScheduler或自定义长连接协议通信，客户端必须与服务端使用完全一致的endpoint配置（包括AntVIP地址、instanceId、zone信息），否则连接建立失败，导致添加请求无法送达。

1、比对客户端代码中com.alipay.instanceid和com.antcloud.antvip.endpoint配置值与控制台注册信息是否完全一致。

2、执行netstat -a | grep 9600，确认客户端进程与AntVIP服务端9600端口存在ESTABLISHED连接。

3、若连接断开，检查防火墙策略及ECS安全组规则，确保出方向9600端口未被拦截。