如何从ASMX端点异步创建/写入文件？

这个场景太戳痛点了——把大体积的XML格式请求/响应DTO直接写日志，确实会让日志文件变成完全没法直接读的“垃圾场”。我之前帮团队落地过类似的方案，核心就是把这些大内容“外置存储”，只在主日志里留个跳转路径，分享几个实操思路：

不管你用Logback还是Log4j2，都可以通过自定义Appender/Filter来实现自动分流：

• 第一步：识别大体积DTO：先写个判断逻辑，比如通过内容是否以XML标签开头、长度超过阈值（比如10KB）来识别需要外置的日志内容；
• 第二步：流式上传到文件服务器：别把整个DTO加载到内存里再传，直接用流式读写（比如从日志的输入流直接对接文件服务器的输出流），避免OOM；文件名建议用「请求ID+时间戳」命名，方便后续关联排查；
• 第三步：替换日志内容为路径：把原本要写的DTO内容替换成文件服务器上的路径，写入主日志，比如：INFO [requestId:xyz789] 接口响应详情：ftp://fileserver/logs/dtos/xyz789_response_202405201430.xml

没有请求ID的话，后续排查问题时根本没法快速找到对应的DTO文件：

• 给每个请求生成唯一的requestId，放到MDC（映射诊断上下文）里，这样日志框架能自动把ID带到每条日志里；
• 上传DTO文件时，把requestId作为文件名的一部分，比如xyz789_response.xml，这样看到主日志里的ID，直接就能找到对应的文件。

别只想着“传上去”，还要处理异常和长期存储的问题：

• 上传失败的降级：如果文件服务器挂了，要不要把DTO内容降级写到本地日志？或者触发告警？根据你的业务容错要求来定；
• 定期清理文件：网络文件服务器的存储不是无限的，要写个定时任务，比如清理7天前的DTO文件，避免存储爆炸；
• 权限控制：确保应用服务器有文件服务器的上传权限，同时限制这些DTO文件的访问权限，避免敏感数据泄露。

给你写个简化版的自定义Appender参考：

public class DtoExternalAppender extends AppenderBase<ILoggingEvent> {
    // 自己封装的文件传输客户端，支持FTP/SFTP/HTTP等
    private RemoteFileClient remoteFileClient;

    @Override
    protected void append(ILoggingEvent event) {
        String logContent = event.getFormattedMessage();
        // 判断是否是需要外置的大体积XML
        if (isLargeXmlDto(logContent)) {
            String requestId = MDC.get("requestId");
            String fileName = String.format("%s_%s.xml", requestId, System.currentTimeMillis());
            String remoteFilePath = "/logs/dtos/" + fileName;

            try (InputStream contentStream = new ByteArrayInputStream(logContent.getBytes(StandardCharsets.UTF_8))) {
                // 流式上传到文件服务器
                remoteFileClient.uploadStream(contentStream, remoteFilePath);
                // 替换日志内容为远程路径
                event.setMessage("[DTO详情] " + remoteFilePath);
                // 写入主日志
                super.append(event);
            } catch (IOException e) {
                // 上传失败，降级写入原内容并记录错误
                addError("上传DTO到文件服务器失败，requestId:" + requestId, e);
                super.append(event);
            }
        } else {
            // 普通日志直接写入
            super.append(event);
        }
    }

    private boolean isLargeXmlDto(String content) {
        // 简单判断：以<开头，且长度超过10KB
        return content.startsWith("<") && content.length() > 1024 * 10;
    }

    // 注入文件客户端的setter，供Logback配置使用
    public void setRemoteFileClient(RemoteFileClient remoteFileClient) {
        this.remoteFileClient = remoteFileClient;
    }
}

然后在Logback的xml配置里引用这个Appender：

<appender name="DTO_EXTERNAL" class="com.yourteam.log.DtoExternalAppender">
    <remoteFileClient class="com.yourteam.file.FtpRemoteFileClient">
        <server>your-file-server.com</server>
        <port>21</port>
        <username>log-uploader</username>
        <password>your-secure-password</password>
    </remoteFileClient>
    <encoder>
        <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} %X{requestId} - %msg%n</pattern>
    </encoder>
</appender>

<!-- 把这个Appender加到你的日志配置里 -->
<root level="info">
    <appender-ref ref="DTO_EXTERNAL"/>
</root>

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