---
title: "Feature: #104321 - Allow handling of argument mapping exceptions in ActionController"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:feature-104321-1720369379"
source: "Changelog/13.3/Feature-104321-AllowHandlingOfArgumentMappingExceptionsInActionController.rst"
typo3-version: "13.3"
typo3-major: 13
type: "feature"
issue: 104321
forge: "https://forge.typo3.org/issues/104321"
tags: ["Frontend", "ext:extbase"]
rendered: "2026-10-03T08:19:36+00:00"
---

# Feature: #104321 - Allow handling of argument mapping exceptions in ActionController {#feature-104321-1720369379}

See [forge#104321](https://forge.typo3.org/issues/104321)

## Description {#description}

A new method `handleArgumentMappingExceptions` has been introduced in
Extbase `\TYPO3\CMS\Extbase\Mvc\Controller\ActionController` to improve
handling of exceptions that occur during argument mapping.

The new method supports optional handling of the following exceptions:

-   `\TYPO3\CMS\Extbase\Property\Exception\TargetNotFoundException`,
    which occurs, when a given object UID can not be resolved to an existing record.
-   `\TYPO3\CMS\Extbase\Mvc\Controller\Exception\RequiredArgumentMissingException`,
    which occurs, when a required action argument is missing.

Handling of the exceptions can be enabled globally with the following TypoScript
configuration.

-   `config.tx_extbase.mvc.showPageNotFoundIfTargetNotFoundException = 1`
-   `config.tx_extbase.mvc.showPageNotFoundIfRequiredArgumentIsMissingException = 1`

The exception handling can also be configured on extension level with the
following TypoScript configuration.

-   `plugin.tx_yourextension.mvc.showPageNotFoundIfTargetNotFoundException = 1`
-   `plugin.tx_yourextension.mvc.showPageNotFoundIfRequiredArgumentIsMissingException = 1`
-   `plugin.tx_yourextension_plugin1.mvc.showPageNotFoundIfTargetNotFoundException = 1`
-   `plugin.tx_yourextension_plugin1.mvc.showPageNotFoundIfRequiredArgumentIsMissingException = 1`

By default, these options are set to `0`, which will lead to exceptions
being thrown (and would lead to errors, if not caught). This is the current
behavior of TYPO3.

When setting one of these values to `1`, the configured exceptions will not be thrown.
Instead, a `pageNotFound` response is propagated, resulting in a 404 error being
shown.

Additionally, extension authors can extend or override the method
`handleArgumentMappingExceptions` in relevant Controllers in order
to implement custom argument mapping exception handling.

## Impact {#impact}

Extension authors can now handle exceptions in implementations of a
`\TYPO3\CMS\Extbase\Mvc\Controller\ActionController`,
which are thrown during argument mapping.