# grpc: WithBlock is deprecated and will be removed in a future release

- **ID:** `go/grpc-dial-deprecated-withblock`
- **Domain:** go
- **Category:** module_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

grpc.Dial with grpc.WithBlock() blocks until the connection is ready; the API is deprecated in favor of grpc.NewClient which does not block.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| google.golang.org/grpc 1.63+ | active | — | — |

## Workarounds

1. **** (90% success)
   ```
   Use grpc.NewClient and trigger connection lazily:
conn, err := grpc.NewClient(target, opts...)
if err != nil { return err }
// force a connection when needed:
conn.Connect()
conn.WaitForStateChange(ctx, connectivity.Idle)
   ```
2. **** (85% success)
   ```
   If you truly need blocking connect semantics, use a health check RPC:
client := pb.NewHealthClient(conn)
_, err = client.Check(ctx, &pb.HealthCheckRequest{})
   ```

## Dead Ends

- **** — Does not fix the underlying behavior change; WithBlock will be removed and the build will break. (70% fail)
- **** — grpc.NewClient rejects WithBlock and returns an error at construction time. (95% fail)
