c#集成dapr关键在三件事：显式指定sidecar地址（如http://localhost:3500）、组件yaml必须正确挂载且name严格匹配、禁用dapr.aspnetcore与手动daprclient混用；new daprclient()默认连localhost:80导致connection refused，须用createinvokeclient或builder指定地址；err_state_store_not_configured表明sidecar未加载对应statestore组件，需检查yaml路径、文件名、metadata.name一致性及dapr components输出。
直接上结论：C# 项目集成 Dapr 不是“装个包就能用”，关键在三件事——DaprClient 必须显式指定 sidecar 地址、状态/发布订阅组件 YAML 必须正确挂载且名字严格匹配、不能同时混用 Dapr.AspNetCore 和手动 DaprClient 初始化。
new DaprClient() 为什么总报 connection refused
这是本地开发最常卡住的第一步。默认构造函数 new DaprClient() 会尝试连 http://localhost:80，而 Dapr sidecar 实际监听的是 http://localhost:3500（HTTP 模式）或 http://localhost:50001（gRPC 模式）。
- 本地调试必须用
DaprClient.CreateInvokeClient("http://localhost:3500")或new DaprClientBuilder().UseHttpEndpoint("http://localhost:3500").Build() - 若走 gRPC（性能更好），sidecar 启动时得加
--app-port 5000，代码里则用UseGrpcChannelOptions()并确保端口一致 - 启动后务必验证：
curl http://localhost:3500/v1.0/healthz返回204 No Content才算 sidecar 真就绪 - Kubernetes 环境下地址不是
localhost，而是http://<app-id>.dapr.svc.cluster.local:3500</app-id>，其中<app-id></app-id>是目标服务的--app-id值，不是 service 名也不是 component 名
DaprClient.SaveStateAsync 报 ERR_STATE_STORE_NOT_CONFIGURED
这个错误 100% 是 Dapr runtime 层的问题，和 C# 代码无关。它只说明 sidecar 根本没加载你声明的状态组件。
- 检查 YAML 文件是否存在且路径被 sidecar 正确加载：启动命令必须带
--components-path ./components，且文件名不能是statestore.yaml.bak这类被忽略的扩展名 - YAML 中
metadata.name必须和代码里SaveStateAsync("statestore", ...)的第一个参数完全一致，大小写敏感 - YAML 内容至少包含
type: state.redis（或state.memory）、version: v1，且metadata.namespace与你的应用部署 namespace 一致（K8s 下） - 运行
dapr components命令，确认输出里有你定义的 statestore 条目；没有就说明挂载失败或 YAML 语法错
为什么同时引用 Dapr.AspNetCore 和 Dapr.Client 会出随机 HttpRequestException
两者底层都用 HttpClient，但初始化策略冲突：一个由 ASP.NET Core DI 管理生命周期，一个由你手动 new。连接池复用错乱后，表现就是偶发超时、连接重置或 SocketException。
- 纯控制台/Worker Service 调用其他服务 → 只用
Dapr.Client包，手动构建DaprClient - ASP.NET Core Web API 接收 Dapr service invocation 请求 → 用
Dapr.AspNetCore，靠[DaprServiceInvocationTrigger]或UseCloudEvents()处理入站调用 - 同一个项目里绝对不要同时调用
services.AddDapr()和new DaprClient()；若需双向通信（既被调也调人），统一走DaprClient，入站请求改用原生 HTTP controller +DaprClient调下游
真正容易被忽略的点是：YAML 组件名、代码里传的 store name、CLI 启动时的 --app-id，这三者在跨环境部署时极易因大小写、中划线、命名空间不一致而静默失败——它们不会报错，只是调用返回空或超时。每次换环境，先比对这三项再查日志。
