ColdFusion/Lucee中cfdirectory生成可下载文档列表遇链接无效问题

你生成的链接用的是本地磁盘绝对路径（比如J:\Downloads\documents\file.zip），浏览器出于安全限制，不允许直接访问本地文件系统的路径——哪怕路径显示正确，点击也不会有反应。另外，Web服务器也没有把这个磁盘目录映射成可公开访问的Web路径，这是核心问题。

下面提供两种可行的解决方式：

方式一：配置Web服务器虚拟目录（直接通过Web访问文件） #

1. 在Web服务器中创建虚拟目录：
   • 若用IIS：在站点下添加虚拟目录，别名设为/downloads，物理路径指向J:\Downloads\documents。
   • 若用Apache：在配置文件中添加Alias /downloads "J:/Downloads/documents"，并设置目录权限允许读取。
2. 修改链接生成代码：
   把本地磁盘路径替换成Web可访问的虚拟目录路径，同时保留子目录结构：

   <ul>
       <cfoutput query="#downloads#">
           <!--- 替换本地路径前缀为Web虚拟目录路径 --->
           <cfset webPath = replace(downloads.directory, expandpath("/downloads"), "/downloads", "all")>
           <li><a href="#webPath#/#downloads.name#">#downloads.name#</a></li>
       </cfoutput>
   </ul>
   

方式二：用ColdFusion脚本中转下载（更安全） #

这种方式适合不想暴露文件真实Web路径的场景，还能添加权限验证：

1. 创建下载处理脚本downloadFile.cfm：

   <!--- 接收要下载的文件路径参数 --->
   <cfparam name="url.filePath" type="string" default="">
   
   <!--- 验证文件是否在允许的目录内，防止目录遍历攻击 --->
   <cfset allowedRoot = expandpath("/downloads")>
   <cfset targetFile = expandpath(url.filePath)>
   <cfset fileDir = getFileInfo(targetFile).directory>
   
   <cfif not findNoCase(allowedRoot, fileDir) or not fileExists(targetFile)>
       <cfoutput>无权访问该文件或文件不存在</cfoutput>
       <cfabort>
   </cfif>
   
   <!--- 设置下载响应头，触发浏览器下载 --->
   <cfset fileInfo = getFileInfo(targetFile)>
   <cfheader name="Content-Disposition" value="attachment; filename=#encodeForURL(fileInfo.name)#">
   <cfcontent type="#getMimeType(fileInfo.name)#" file="#targetFile#" deletefile="no">
   

2. 修改列表链接指向该脚本：

   <ul>
       <cfoutput query="#downloads#">
           <cfset relativePath = replace(downloads.directory, expandpath("/downloads"), "/downloads", "all")>
           <cfset downloadUrl = "downloadFile.cfm?filePath=#encodeForURL(relativePath & "/" & downloads.name)#">
           <li><a href="#downloadUrl#">#downloads.name#</a></li>
       </cfoutput>
   </ul>
   

• 确保Web服务器运行账户对J:\Downloads\documents目录有读取权限，否则ColdFusion无法读取文件。
• 不要直接在前端暴露本地磁盘路径，存在安全风险（比如目录遍历攻击）。

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