All articles / Category
.NET
.NET development notes: debugging, runtime behavior and tooling.

Diagnosing and Hardening a .NET AI Pipeline Adapter
A production .NET AI pipeline can fail even when a provider returns syntactically valid JSON. This troubleshooting guide follows the verified failure chain: a reflection indexer, nested-record deserialization, unexpected array shapes, objects in string arrays, guessed field names, and an invalid reason code. It then records the adapter fixes and the verified rerun results.

Diagnosing Gemini HTTP 400 Errors Caused by Incompatible MCP Tool Schemas
A Gemini-family integration can reject every request when one MCP tool declaration uses nullable JSON-Schema unions that are incompatible with Gemini function-declaration validation. Indexed declaration errors can identify the affected tools, while a non-Gemini comparison and a focused schema-compatibility check help separate schema failures from authentication and quota problems.

Idempotency Isn't Enough: Three Retry Bugs in Pipelines with Retrying
Even with stable IDs, unique constraints and retries, a pipeline can become inconsistent after a crash. Learn how to protect artifacts and task order.

Debugging TargetParameterCountException in .NET: hidden indexer in IReadOnlyList<T>
When .NET reflection throws "Parameter count mismatch", the real cause may be an IReadOnlyList<T> indexer. Learn how to find and fix it.