---
schema_version: "1"
id: 57355522ae8addd8bd32a638f727c19f8cdf592105720da7deec5e2c9b74f611
title: A2A Connector 1.1 Troubleshooting
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/a2a-connector/1.1/a2a-connector-troubleshooting.md
canonical_url: https://docs.mulesoft.com/a2a-connector/1.1/a2a-connector-troubleshooting
source_site: docs.mulesoft.com
content_type: documentation
content_hash: dee4492e52bdacbdb24a82c6671ec91b9d744a847a3e013aa8228c117265b928
description: MuleSoft Documentation Site
release: "1.1"
latest: false
---
---
product: A2A Connector
version: 1.1
---

# A2A Connector 1.1 Troubleshooting

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

To troubleshoot Anypoint Connector for A2A (A2A Connector), become familiar with the information
about performing general troubleshooting, addressing specific common errors, and interpreting
commonly thrown exception messages.

## Error Unmarshalling String JSON Payload into Type io.a2a.spec.Task. Cause: Argument "content" is Null

Likely cause:

- The payload maps to a task or message schema that expects a non-null text content field, but
  received `null`.

Resolution checklist:

- Ensure every text part includes `kind: "text"` and a non-empty `text` value.

- Avoid sending `content: null` or equivalent nullable fields in message or task parts.

- Validate outbound JSON in Studio using connector metadata types before sending.

- Confirm your DataWeave transformation outputs JSON objects, not quoted JSON strings.

## Failed to Establish SSE Connection

Likely causes:

- Request is sent to `message/send` instead of `message/stream`.

- The server app doesn’t include an active `a2a:task-stream-listener` flow.

- Reverse proxy or gateway strips `text/event-stream` semantics or closes long-lived HTTP
  connections.

Resolution checklist:

- Verify the method is `message/stream`.

- Verify the server flow includes `a2a:task-stream-listener`.

- Confirm HTTP 200 response with `Content-Type: text/event-stream`.

- Check timeout and keepalive settings in intermediary proxies and load balancers.

## A2A Server Config Errors Despite Correct Configuration

Likely causes:

- Invalid `agentPath` to listener route binding.

- Card file path not found at runtime.

- Agent card JSON is malformed or missing capability metadata expected by clients.

Resolution checklist:

- Use `${app.home}/agent-card.json` when deploying to CloudHub.

- Validate card JSON syntax and required top-level fields.

- Confirm `<a2a:connection listenerConfig="…​" agentPath="…​"/>` references a valid
  `http:listener-config`.

- Check app startup logs for binding or card parsing errors before runtime requests.

## See Also

- [A2A Connector Examples](https://docs.mulesoft.com/a2a-connector/1.1/a2a-connector-examples)

- [A2A Connector Reference](https://docs.mulesoft.com/a2a-connector/1.1/a2a-connector-reference)

- [Salesforce Help](https://help.salesforce.com)

- [Known Issues](https://help.salesforce.com/s/issues)