如何在Flutter项目中用Appium实现Web自动化测试？代码报错求助

一、Appium Flutter Driver是否支持Web输出？ #

Appium Flutter Driver不支持Web平台（包括Chrome浏览器），它仅针对Flutter原生移动应用（iOS/Android）提供自动化测试能力。你遇到的报错“Appium Flutter驱动不支持Windows平台，仅支持iOS和Android系统”，本质是因为该驱动本身不兼容Web测试场景，即便在Windows系统上运行Chrome浏览器，也不在其支持范围内。

二、如何在Flutter项目中使用Appium编写Web自动化测试？ #

由于Flutter Driver不支持Web，需使用Appium标准Web驱动（如ChromeDriver）来测试Flutter Web应用，具体步骤如下：

1. 环境准备 #

• 安装Node.js与Appium Server
• 下载与本地Chrome版本匹配的ChromeDriver，将其加入系统PATH，或在代码中指定路径
• 编译Flutter项目为Web产物：flutter build web

2. 编写测试代码（JavaScript示例） #

替换原Flutter Driver相关代码，采用标准WebDriver协议实现：

const { remote } = require('webdriverio');

(async () => {
    const driver = await remote({
        hostname: 'localhost',
        port: 4723,
        path: '/wd/hub',
        capabilities: {
            browserName: 'chrome',
            'goog:chromeOptions': {
                args: ['--start-maximized']
            }
        }
    });

    // 打开Flutter Web应用（本地路径用file://协议，线上应用直接填URL）
    await driver.url('file:///path/to/your/flutter-project/build/web/index.html');

    // 元素操作示例（用CSS选择器定位）
    await driver.$('#submit-btn').click();

    // 获取页面信息
    const pageTitle = await driver.getTitle();
    console.log('当前页面标题:', pageTitle);

    await driver.deleteSession();
})();

3. 运行测试 #

• 启动Appium Server：在终端执行 appium
• 运行测试脚本：node your-test-script.js

三、报错排查说明 #

你当前的测试代码大概率配置了automationName: 'Flutter'这类Flutter Driver专属参数，导致驱动尝试以移动应用模式运行，从而触发不支持Windows/Web的报错。只需移除Flutter Driver相关配置，改用上述标准Web测试方案即可解决。

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