GeneXus .NET调用Mifiel API上传PDF遇HTTP 500或空白页

问题描述 #

我在GeneXus Web面板中通过.NET生成器生成C#代码，向Mifiel API发送multipart/form-data类型的POST请求，上传PDF文档及签署者元数据，但请求失败：要么返回HTTP 500内部服务器错误，要么GeneXus应用直接显示空白屏（运行时错误），怀疑是GeneXus构建请求体时的文件部分存在问题。

代码片段 #

按钮事件中的GeneXus代码如下（已将文件持久化到服务器磁盘，采用Basic认证）：

Event 'DoUserActionFirmar'
    // 变量说明：
    // &RutaArchivo（字符型）存储绝对路径：C:\Temp\...\file.pdf
    // &Contrato（File类型）存储上传内容
    // &HttpClient（HttpClient）
    
    // 1. 将文件持久化到服务器磁盘（已执行&Contrato.Save(&RutaArchivo)）
    
    // 2. 配置HTTP客户端
    &HttpClient.Host = "app-sandbox.mifiel.com"
    &HttpClient.Port = 443
    &HttpClient.Secure = True

    // 3. Basic认证
    // ...（计算&EncodedCredentials的逻辑）...
    &HttpClient.AddHeader("Authorization", "Basic " + &EncodedCredentials)

    // 4. 添加文件和变量
    &HttpClient.AddFile(&RutaArchivo, "file") // 以参数名"file"发送PDF
    
    // 元数据
    &HttpClient.AddVariable("signatories[0][name]", &NombreProfesor.Trim())
    &HttpClient.AddVariable("signatories[0][email]", &CorreoProfesor.Trim())
    &HttpClient.AddVariable("signatories[0][tax_id]", &RfcProfesor.Trim())
    &HttpClient.AddVariable("send_invites", "true")

    // 5. 执行请求
    &HttpClient.Execute("POST", "/api/v1/documents")

    &StatusCodeNum = &HttpClient.StatusCode
    &JsonText = &HttpClient.ToString()

    If &StatusCodeNum <> 201
        // 错误处理逻辑
    EndIf
EndEvent

已尝试操作 #

• 确认调用AddFile前，&RutaArchivo路径下的文件存在；
• 曾手动添加Content-Type: multipart/form-data头部，但因GeneXus未自动添加boundary参数导致明确500错误，已移除该头部；
• 空白屏似乎在AddFile遇到未处理异常（如文件权限、文件不存在）时出现。

疑问 #

在GeneXus .NET中，如何确保HttpClient通过AddFile正确打包文件，结合AddVariable构建multipart/form-data请求？是否存在文件权限或GeneXus配置方面的已知陷阱，导致AddFile静默失败或服务器返回500错误？

解决方案与排查要点 #

1. 规范AddFile的文件处理逻辑 #

GeneXus的HttpClient.AddFile在.NET环境下依赖底层文件读取权限和流处理，需注意：

• 验证文件读取权限：服务器运行GeneXus应用的进程（如IIS应用池用户）必须拥有&RutaArchivo路径的读取权限。若使用临时目录，确保IIS_IUSRS或对应应用池用户有读权限，避免因权限不足触发未捕获异常（即空白屏问题）。
• 显式指定文件MIME类型：默认情况下GeneXus可能无法正确识别PDF类型，建议补充第三个参数指定application/pdf：

  &HttpClient.AddFile(&RutaArchivo, "file", "application/pdf")
  

  Mifiel API对文件类型校验严格，缺失正确的Content-Disposition和Content-Type头部会导致服务器500错误。

2. 确认Multipart请求的边界处理 #

虽然已移除手动添加的Content-Type头部，仍需验证GeneXus是否自动生成了正确的boundary：

• 执行请求前，通过&HttpClient.GetHeader("Content-Type")检查是否包含boundary=参数。若未包含，可能是GeneXus版本bug，建议升级到GeneXus 17+等主流版本，旧版本处理混合文件和变量的multipart请求时可能存在边界生成异常。

3. 完善异常捕获逻辑 #

空白屏的核心原因是未处理AddFile或Execute阶段的异常，需添加局部try-catch块：

Event 'DoUserActionFirmar'
    Try
        // 原有的配置、AddFile、AddVariable、Execute逻辑
        
        &StatusCodeNum = &HttpClient.StatusCode
        &JsonText = &HttpClient.ToString()

        If &StatusCodeNum <> 201
            Msg("请求失败，状态码：" + &StatusCodeNum.ToString() + "，详情：" + &JsonText)
        EndIf
    Catch
        Msg("运行时错误：" + Exception.Message)
        // 可选：记录日志到服务器文件
        &LogFile.WriteLine("错误时间：" + DateTime.Now.ToString() + "，错误信息：" + Exception.Message)
    EndTry
EndEvent

通过捕获异常可直接定位问题，避免空白屏。

4. 验证API请求的参数格式 #

Mifiel API对参数格式有严格要求，需确认：

• 使用Postman手动构造完全相同的请求（参数+文件），测试是否能成功调用API。若Postman成功，说明GeneXus的参数构造存在问题；
• 检查tax_id（RFC）是否符合Mifiel格式要求，send_invites尝试使用布尔值而非字符串：

  &HttpClient.AddVariable("send_invites", True)
  

5. 排查GeneXus配置层面的陷阱 #

• 临时目录配置：若&RutaArchivo使用GeneXus临时目录，确认GeneXus.ini中TempPath配置的目录权限正确，且目录未被自动清理；
• HttpClient实例化：确保&HttpClient为每次请求重新实例化的局部变量，全局复用实例可能导致请求头或边界残留引发异常；
• .NET生成器设置：在GeneXus的.NET生成器配置中，开启AllowUnsafeHeaderParsing，某些情况下服务器返回的非常规头部会导致HttpClient解析失败，可在web.config中添加对应配置缓解此问题。

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