文件上传报错：表单字段uploadedFile未包含文件

问题代码 #

前端表单：

<form method="post" action="upload.cfm" enctype="multipart/form-data">
    <table>
        <tbody>
            <tr>
                <td><input type="file" name="uploadFile" id="uploadFile"></td>
            </tr>
            <tr>
                <td><input type="submit" name="Upload" id="Upload" value="Upload"></td>
            </tr>
        </tbody>
    </table>
</form>  

upload.cfm：

<cfif isDefined('form.upload')>
    <cfset results = uploadAndInsertData('#FORM.uploadFile#')>
</cfif>  

上传函数：

<cffunction name="uploadAndInsertData" access="public" returntype="any">
    <cfargument name="uploadedFile" type="any" required="true">
    <cfset targetFolder = ExpandPath('documents')>
    <cfset success = true>

    <cfset cffile = UploadFile(
        FileField = "uploadedFile", 
        destination = "#targetFolder#"
    )>
    <cfset fileContent = fileRead("#targetFolder##uploadedFile#")>
</cffunction>

报错信息：

表单字段uploadedFile未包含文件

报错对应UploadFile函数内代码行：

22 :      <cffile action="upload" filefield="#Arguments.FileField#" destination="#Arguments.TempDirectory#" nameconflict="MakeUnique">

错误原因 #

1. 函数传参错误：调用uploadAndInsertData时，你传递的是FORM.uploadFile的字段值，但文件上传需要的是表单字段的名称（即字符串"uploadFile"），函数要通过字段名识别上传的文件对象，而非字段值。
2. 参数硬编码问题：uploadAndInsertData函数里调用UploadFile时，硬写了FileField = "uploadedFile"，没有使用传入的参数，导致无法正确匹配表单里的文件字段。
3. 文件路径拼接错误：fileRead的路径拼接逻辑错误，应该用UploadFile返回的cffile对象中的文件信息构建路径，而不是直接拼接目标文件夹和传入参数。

修复后的代码 #

1. 修正upload.cfm的函数调用：

<cfif isDefined('form.Upload')>
    <!--- 传递表单字段名称，而非字段值 --->
    <cfset results = uploadAndInsertData("uploadFile")>
</cfif>  

2. 修正uploadAndInsertData函数：

<cffunction name="uploadAndInsertData" access="public" returntype="any">
    <cfargument name="fileFieldName" type="string" required="true">
    <cfset targetFolder = ExpandPath('documents')>
    <cfset success = true>

    <!--- 使用传入的字段名称调用UploadFile --->
    <cfset cffile = UploadFile(
        FileField = arguments.fileFieldName, 
        destination = targetFolder
    )>
    
    <!--- 使用cffile返回的完整路径读取文件 --->
    <cfset fileContent = fileRead(cffile.filePath)>
    
    <!--- 可在此添加数据库插入等业务逻辑 --->
    
    <cfreturn {success: success, fileContent: fileContent, cffile: cffile}>
</cffunction>

额外注意事项 #

• 确保documents文件夹存在且具备写入权限，否则会出现文件写入失败的错误。
• 建议添加<cftry>/<cfcatch>错误捕获逻辑，处理文件大小超限、权限不足等异常场景。

内容的提问来源于stack exchange，提问作者Dunn