Java应用必须通过dapr run启动以与Sidecar共处同一网络命名空间，使用localhost:3500（HTTP）或localhost:50001（gRPC）通信；State Store名称须与components/YAML中metadata.name严格一致；健康检查失败常因Sidecar未就绪或DaprHealthIndicator触发；Pub/Sub需发布端、订阅端组件名及topic路径精准匹配，且订阅路径须可被Sidecar访问。
Java应用怎么连上Dapr Sidecar
必须通过 localhost:3500（HTTP）或 localhost:50001（gRPC）跟Sidecar通信，Dapr默认不暴露外部网络，也不自动代理本地端口。Java进程和Dapr Sidecar得在同一个网络命名空间里——最稳的方式是用 dapr run 启动Java应用，而不是单独跑Java再手动连。
- 别直接在IDE里点运行按钮启动Java主类，那样Sidecar根本不知道它存在
- 用
dapr run --app-id myapp --app-port 8080 --dapr-http-port 3500 -- java -jar target/myapp.jar，确保--app-port和你Spring Boot的server.port一致 - 如果用了gRPC SDK，记得加
--dapr-grpc-port 50001，且Java代码里初始化DaprClientBuilder时显式指定grpc://localhost:50001 - Spring Boot项目若引入了
spring-cloud-starter-dapr，它会自动配HTTP endpoint，但只认3500；换端口就得重写DaprProperties配置
为什么DaprClient调用状态服务返回404
不是Java SDK写错了，大概率是State Store组件没正确定义或没加载。Dapr的state API路径是 /v1.0/state/<store-name>，而 store-name 必须和你部署在 components/ 目录下的YAML文件名、metadata.name 完全一致，且该文件得被Dapr进程实际读到。
- 检查
components/statestore.yaml是否放在Dapr启动时指定的--components-path下（默认是当前目录的components子目录） - 确认文件里有
type: state.redis或type: state.memory，且version: v1—— Dapr v1.12+ 已弃用v1alpha1 - Java里调用
saveState("mystore", "key1", "value")，其中"mystore"必须等于YAML里的metadata.name，大小写敏感 - 启动Dapr时加
--log-level debug，看日志里有没有loaded component mystore (state.redis)这行，没有就说明组件没加载成功
Spring Boot集成Dapr SDK后为啥Actuator健康检查失败
因为 spring-boot-starter-actuator 默认把所有 HealthIndicator 拉进来，而Dapr的 DaprHealthIndicator 会主动去连Sidecar的 /v1.0/healthz。如果Sidecar没起来、端口不对、或网络不通，整个 /actuator/health 就会返回 DOWN，连带影响K8s readiness probe。
- 临时解法：在
application.yml里关掉它：management.health.dapr.show-details: never，或者直接禁用：management.health.dapr.enabled: false - 长期建议：不要依赖Dapr自身的健康端点做业务就绪判断，改用自定义
HealthIndicator检查你真正关心的资源（比如Redis连接、下游服务连通性） - 注意
DaprClient是线程安全的，但别在@PostConstruct里就急着调用远程方法——Sidecar可能还没ready，建议加简单重试或延迟初始化
Java里用Dapr发布事件，消费者收不到
Pub/Sub不是“发了就到”，必须两边都正确定义Topic和Component，且订阅方得主动向Sidecar注册监听路径。Java SDK的 publishEvent 只负责发，不保证对方已订阅；而 @DaprComponent 注解（或手动注册 Topic）只是告诉Spring“我支持这个Topic”，真正注册动作发生在应用启动时调用Dapr的 /dapr/subscribe 接口。
立即学习“Java免费学习笔记（深入）”；
- 发布端确保
publishEvent("pubsub", "topicA", data)的第一个参数"pubsub"是你components/pubsub.yaml里metadata.name的值 - 订阅端必须有一个HTTP handler，路径为
/topic/topicA（注意前缀/topic/），且这个路径要能被Dapr Sidecar访问到（即Java服务的app-port对Sidecar可连） - 启动日志里搜
Subscribed to topics，看到类似Subscribed to topics: [topicA]才算注册成功；没这句说明订阅没生效 - 别用
localhost做回调地址——Dapr Sidecar在容器里跑时，它访问的是自己网络命名空间里的localhost，不是你的Java进程
Dapr对Java应用的侵入性比想象中小，但所有“自动”背后都依赖精准的命名匹配和启动时序。最容易卡住的地方不是代码，而是YAML文件名拼错、组件没加载、或者Sidecar和App没跑在同一个 --network 下。调试时先盯紧Dapr CLI输出的日志，而不是Java堆栈。
