How do I fix ADF Pipeline Error 2331?

Open the failing activity in ADF Monitor and inspect the input JSON to confirm which path field is empty.. Trace the dataset's filePath/folderPath back to its source parameter, variable, or expression.. Provide a valid path to an existing file — set the parameter default, fix the upstream variable, or correct the expression.. Validate the dataset with 'Test connection' and 'Browse' to confirm the path resolves to a real file.. Rerun the pipeline and verify the activity input shows a non-empty path.

High severityconfigurationAzure Data Factory →

ADF Pipeline Error:
ADF Pipeline Error 2331

What does this error mean?

The provided file path is empty. Provide a path for a file that exists.

Common causes

1Dataset filePath/folderPath parameter resolved to an empty string at runtime
2Pipeline parameter or variable feeding the path was never set or is null
3Dynamic content expression returned empty (e.g. @pipeline().parameters.fileName unset)
4Linked service or dataset misconfigured with a blank file/folder field

How to fix it

1Open the failing activity in ADF Monitor and inspect the input JSON to confirm which path field is empty.
2Trace the dataset's filePath/folderPath back to its source parameter, variable, or expression.
3Provide a valid path to an existing file — set the parameter default, fix the upstream variable, or correct the expression.
4Validate the dataset with 'Test connection' and 'Browse' to confirm the path resolves to a real file.
5Rerun the pipeline and verify the activity input shows a non-empty path.

Frequently asked questions

What causes ADF Pipeline Error 2331?

Pipeline configuration or connectivity issue

Where can I find more details?

Open Azure Data Factory Monitor, find the failed run, click on the activity, and view the full error output in the Output tab.

Source · learn.microsoft.com/en-us/azure/data-factory/data-factory-troubleshoot-guide#error-code-2331