ColdFusion · Exception

Mail Spool Lock Timeout Exception

What does Mail Spool Lock Timeout Exception mean in ColdFusion?

Thrown by <cfmail> when the mail spooler can't acquire a lock on the mail spool directory within the expected time — typically heavy mail volume or contention/corruption in the spool leaving messages stuck queued rather than sent. Adobe's own explanation of the exact underlying mechanism has stayed vague across several ColdFusion versions.

Mail Spool Lock Timeout ExceptionAdobe ColdFusion

Condition

Thrown by <cfmail> when the mail spooler can't acquire a lock on the mail spool directory within the expected time — typically heavy mail volume or contention/corruption in the spool leaving messages stuck queued rather than sent. Adobe's own explanation of the exact underlying mechanism has stayed vague across several ColdFusion versions.

Fix

Raise the spool lock wait with -Dcoldfusion.spooltimeout=NNNN in jvm.config, or set spoolenable="false" on cfmail to send synchronously and bypass the spooler when mail volume is low.

Pending source verification. Not yet checked against official documentation.

Related exception