Diagnosing an error - Form entries are incomplete or invalid.

This post is more than 2 years old.

Last night a reader of mine wrote with an interesting issue. His error handler was firing off quite a few emails (this would help!) but the error wasn't quite clear. I've recreated the error below and I'll explain how I went about diagnosing it. The short summary is that - once again - ColdFusion's ancient automatic form checker was the culprit, which luckily is easy to get around in ColdFusion 9. But first - let's look at the errors that were generated.

Ok, first - here is a snapshot of what the error looked like:

When I saw this, I immediately noticed that both the Message and the StackTrace talked about form validation. This was my first clue that something with ColdFusion's built in form validation was being triggered. You can read about this feature here. For the most part, no one uses this nor do they even think about it until they accidentally name a field something_required and accidentally trigger it.

Now I asked the developer if he had anything named like that and he said not. But this is an important point. Even if you don't name anything something_required, if a remote request sends that, it will trigger the error. So to be clear, I can force that error on your server right now by just writing my own form. It isn't a big deal for sure, but it is something to remember. Here is where things got weird though. In his error handler he was dumping out the form and it was empty! I noticed his code looked like so:

<cfif isDefined("form.fieldnames")> <cfdump var="#form#" label="FORM"> </cfif>

So - at this point - I was still pretty lost. I asked him to add this to his error handler:

<cfdump var="#getHTTPRequestData()#">

This then revealed form data within the content of the request. I then realized the issue. ColdFusion wasn't populating form.fieldnames. If he had just dumped the form scope itself it would have worked. So for some reason, when a form validation error occurs, form.fieldnames will not exist. Confused yet? Let's look at a complete example. First, my Application.cfc.

<cfcomponent output="false">

&lt;cfset this.name = "demo2"&gt;
&lt;cfset this.sessionManagement = true&gt;

&lt;cffunction name="onApplicationStart" returnType="boolean" output="false"&gt;
	&lt;cfreturn true&gt;

&lt;cffunction name="onError"&gt;
	&lt;cfargument name="exception"&gt;
	&lt;cfargument name="event"&gt;
	&lt;cfdump var="#arguments#" abort&gt;


Next - this is the file being hit by the remote server.

Testing from test3.cfm

<cfdump var="#getHTTPRequestData()#">

Right now it just echos back data. And finally, here is my tester:

<h1>testing from test1</h1>

<cfhttp url="http://localhost/test3.cfm" method="post" result="result"> <cfhttpparam type="formfield" name="stuff" value="ray"> </cfhttp>


Notice the form field is just stuff. Ok, so here is the result of a good post.

And now - let's break it. Here is my new tester:

<h1>testing from test1</h1>

<cfhttp url="http://localhost/test3.cfm" method="post" result="result"> <cfhttpparam type="formfield" name="stuff_required" value="ray"> </cfhttp>


As you can see - I just renamed the field to include something to trip up ColdFusion's validation.

As you can see - even this is a bit confusing. Why is my form value in there? No idea. So what to do?

First off - in ColdFusion 9 you can fix this in two seconds:

<cfset this.serverSideFormValidation = false>

I see no reason to never use this line of code - unless you actually are using that old feature and if so... um... stop. Now unfortunately the user was still on ColdFusion 8. Luckily you can just look at the exception and not email if it happens. Here is an example.

<cffunction name="onError"> <cfargument name="exception"> <cfargument name="event"> <cfif arguments.exception.message is not "Form entries are incomplete or invalid."> <cfdump var="#arguments#" abort> </cfif> </cffunction>

Since the remote site wasn't doing anything valid on the server anyway, this is probably a fine response. (Although I'd also consider noting the IP and blocking it at the network level.)

Anyway - I hope this helps others!

Raymond Camden's Picture

About Raymond Camden

Raymond is a senior developer evangelist for Adobe. He focuses on document services, JavaScript, and enterprise cat demos. If you like this article, please consider visiting my Amazon Wishlist or donating via PayPal to show your support. You can even buy me a coffee!

Lafayette, LA https://www.raymondcamden.com

Archived Comments

Comment 1 by David R. McGraw posted on 10/15/2010 at 7:03 PM

Interesting... I never have, not never wil use CF's form auto anythings, but none the less, this is interesting, good find.

Comment 2 by Raymond Camden posted on 10/15/2010 at 7:07 PM

And that's kind of the point - he wasn't using it either - but it definitely reared it's ugly head.

Comment 3 by johans posted on 10/16/2010 at 12:28 AM

@Ray - interesting - so to confirm in CF9 the application serversideFormValidation setting affects all forms?

The CF9 docs say cfform specifically - "If no, disables validation on cfform fields when the form is submitted"

Comment 4 by Raymond Camden posted on 10/16/2010 at 12:29 AM

I think it would be better written as -

If form data is sent to your server (who cares if it is from your server or some remote POST) then validation will be ignored.

Comment 5 by John Schortz posted on 6/2/2012 at 7:20 PM

Came across this page from a Google search on "coldfusion server error form entries are incomplete or invalid". When I saw your reference to "_required" I immediately knew that was my problem!

While I didn't read passed the second paragraph, I'm sure the rest of the article was great too ;-) Thanks!

Comment 6 by Raymond Camden posted on 6/2/2012 at 7:23 PM

You wouldn't be the first tech person to skim. ;)

Comment 7 (In reply to #5) by pinto xavier posted on 3/31/2017 at 12:54 AM


Comment 8 by Jeffrey Bender posted on 7/12/2019 at 12:16 PM

Thank you Ray!! Had a field XXX_DATE that was tripping the error. I saw it and was like, what is this? I added this.serverSideFormValidation = false; to my cfc and I'm a happy coder!

Comment 9 (In reply to #8) by Raymond Camden posted on 7/12/2019 at 12:21 PM

Happy this old post helped! :)

Comment 10 by Parag Shah posted on 12/20/2019 at 1:56 PM

Hi Raymond, I have a similar issue with form field named with xxx_Required which triggers the alert on form submission. I am using HTML form instead of CFForm. I set this.serverSideFormValidation to 'false' in my save function in component, but the alert still occurs. I am using CF 2018.