ASP.NET网站从AWS下载.docx变为.doc的解决问询

可能原因及对应解决方法 #

1. 检查S3对象的Content-Type配置 #

S3默认会根据文件扩展名自动匹配Content-Type，但如果上传时配置错误（比如把docx文件的Content-Type设成了application/msword，对应doc格式），浏览器会根据这个类型自动修改下载后的扩展名。

• 登录AWS控制台，找到目标S3桶和文件，查看属性面板里的Content-Type：
  • docx格式的正确Content-Type是application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • 如果配置错误，直接修改该文件的Content-Type；后续上传文件时，也要确保代码指定正确的类型。

2. 生成签名URL时强制指定响应头 #

你的GetSignedFileUri方法可能没在生成预签名URL时指定响应头，导致浏览器根据默认规则篡改文件名。修改该方法，添加ResponseHeaderOverrides强制锁定文件名和Content-Type：

Public Shared Function GetSignedFileUri(ByVal filePath As String, ByVal fileName As String) As String
    Dim request As New GetPreSignedUrlRequest() With {
        .BucketName = bucketName,
        .Key = filePath,
        .Expires = DateTime.UtcNow.AddMinutes(10)
    }
    ' 强制设置下载文件名和内容类型
    request.ResponseHeaderOverrides.ContentDisposition = $"attachment; filename=""{fileName}"""
    request.ResponseHeaderOverrides.ContentType = "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
    
    Return client.GetPreSignedURL(request)
End Function

注意：确保传入的fileName参数是带.docx后缀的完整文件名，比如report.docx而非report。

3. 验证前端参数传递的正确性 #

前端AJAX请求里传递了fileName和fileExt参数，要确认两者拼接后是正确的.docx格式：

• 在前端控制台打印fileName + fileExt，检查结果是否为xxx.docx
• 排查是否存在fileExt被错误赋值为.doc的情况

4. 修复前端iframe重复添加的错误 #

你的前端代码存在DOM操作错误，重复添加了iframe：

document.body.appendChild(iframe);
document.body.document.body.appendChild(iframe);

删掉第二行错误代码，避免不必要的DOM异常。

5. 备选方案：直接输出文件流而非预签名URL #

如果预签名URL方式仍有问题，可以修改后端代码，直接从S3拉取文件流并通过ASP.NET Response输出，严格控制响应头：

Public Shared Sub DownloadS3FileDirect(ByVal filePath As String, ByVal fileName As String, ByVal response As HttpResponse)
    Dim chain As CredentialProfileStoreChain = New CredentialProfileStoreChain("C:\Aws\.aws\credentials")
    Dim awsCredentials As AWSCredentials

    If chain.TryGetAWSCredentials("lifebackup-profile", awsCredentials) Then
        Using client As New AmazonS3Client(awsCredentials, bucketRegion)
            Dim request As New GetObjectRequest() With {
                .BucketName = bucketName,
                .Key = filePath
            }
            Using responseObj As GetObjectResponse = client.GetObject(request)
                ' 设置响应头
                response.ContentType = "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
                response.AddHeader("Content-Disposition", $"attachment; filename=""{fileName}""")
                ' 将文件流写入Response
                responseObj.ResponseStream.CopyTo(response.OutputStream)
                response.End()
            End Using
        End Using
    End If
End Sub

之后在dlS3File.aspx的后台代码中调用这个方法，直接输出文件流即可。

总结 #

优先排查S3文件的Content-Type配置和预签名URL的响应头设置，这是此类问题的核心原因。同时确认前端参数传递正确，修复DOM操作错误。如果问题仍存在，改用直接输出文件流的方式会更可控。

内容的提问来源于stack exchange，提问作者dibello.4