Dramatiq

visibility_timeout parameter not supported as actor option

warning
configurationUpdated Apr 21, 2025(via Exa)
Technologies:
How to detect:

Attempting to use visibility_timeout as a parameter in the @dramatiq.actor decorator causes ValueError on module import, preventing worker startup. This parameter is not a valid actor option and requires middleware configuration instead.

Recommended action:

Remove visibility_timeout from @dramatiq.actor decorator parameters. Configure visibility timeout at the broker/middleware level rather than per-actor. Verify actor decorator only uses supported options before deployment.