WSO2微集成器中通过SMB将SFTP文件迁移至Windows共享目录

你遇到的jcifs.smb.SmbAuthException: Logon failure: unknown user name or bad password错误，核心是WSO2 Micro Integrator（MI）4.0.0的VFS代理在SMB认证时的逻辑，和你单独测试的Java代码存在差异。以下是针对性的解决步骤：

1. 修正SMB URI的域格式 #

Windows SMB认证对域/本地用户的格式要求严格，MI的JCIFS客户端默认不会自动识别域，需显式在URI中指定：

• 域用户：用%5C转义反斜杠，格式为smb://DOMAIN%5Cusername:password@hostname/sharename/path
• 本地用户：用主机名作为域，格式为smb://HOSTNAME%5Cusername:password@hostname/sharename/path

示例修改后的MoveAfterProcess参数：

<parameter name="transport.vfs.MoveAfterProcess">smb://DOMAIN%5C[your-username]:[your-password]@[hostname]/[share-path]?transport.vfs.AvoidPermissionCheck=true</parameter>

2. URL编码凭证中的特殊字符 #

如果密码包含@、:、/等特殊字符，必须进行URL编码（比如P@ssw0rd转成P%40ssw0rd），否则URI解析时会截断凭证，导致认证失败。

3. 对齐JCIFS版本 #

检查MIlib目录下的JCIFS jar版本，确保和你测试用的Java代码版本完全一致。MI 4.0.0默认使用的JCIFS版本可能和你单独测试的存在差异（比如JCIFS vs JCIFS-NG），不同版本的认证逻辑有细微区别。

4. 添加JCIFS系统属性 #

在MI的启动脚本（bin/micro-integrator.sh或micro-integrator.bat）中添加以下系统属性，强制指定认证参数：

# Linux/macOS
-Djcifs.smb.client.domain=YOUR_DOMAIN
-Djcifs.smb.client.authType=NTLM
-Djcifs.smb.client.useExtendedSecurity=false

# Windows
-Djcifs.smb.client.domain=YOUR_DOMAIN ^
-Djcifs.smb.client.authType=NTLM ^
-Djcifs.smb.client.useExtendedSecurity=false

部分Windows服务器需要关闭扩展安全认证才能兼容旧版JCIFS客户端。

5. 补充SMB相关VFS参数 #

在代理配置中添加SMB被动模式参数，避免连接超时：

<parameter name="transport.vfs.SMB.PassiveMode">true</parameter>

修改后的完整代理配置示例 #

<proxy name="WindowsShare" startOnLoad="true" transports="http https vfs" xmlns="http://ws.apache.org/ns/synapse">
    <target>
        <inSequence>
            <log>
                <property name="STATUS" value="Reading File Data"/>
                <property name="XML data from file" expression="$body/*"/>
            </log>
            <property expression="get-property('transport','FILE_NAME')" name="filename" scope="default" type="STRING"/>
            <log level="custom">
                <property expression="get-property('transport','FILE_NAME')" name="filename"/>
            </log>
        </inSequence>
        <outSequence/>
        <faultSequence/>
    </target>
    <parameter name="transport.PollInterval">15</parameter>
    <parameter name="transport.vfs.FileURI">sftp://[username]:[password]@[hostname]:22/[filePath]?sftpPathFromRoot=true&amp;transport.vfs.AvoidPermissionCheck=true</parameter>
    <parameter name="transport.vfs.ContentType">text/xml</parameter>
    <parameter name="transport.vfs.ResolveHostsDynamically">true</parameter>
    <parameter name="transport.vfs.ActionAfterProcess">MOVE</parameter>
    <parameter name="transport.vfs.MoveAfterFailure">sftp://[username]:[password]@[hostname]:22/[filePath]?sftpPathFromRoot=true&amp;transport.vfs.AvoidPermissionCheck=true</parameter>
    <parameter name="transport.vfs.ActionAfterFailure">MOVE</parameter>
    <parameter name="transport.vfs.FileNamePattern">.*.xml</parameter>
    <!-- 带域编码的SMB路径 -->
    <parameter name="transport.vfs.MoveAfterProcess">smb://DOMAIN%5C[username]:[encoded-password]@[hostname]/[share-path]?transport.vfs.AvoidPermissionCheck=true</parameter>
    <!-- 启用SMB被动模式 -->
    <parameter name="transport.vfs.SMB.PassiveMode">true</parameter>
</proxy>

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