如何在Protractor端到端测试中为无头Chrome传递客户端证书？

刚好之前帮团队解决过类似的需求，其实核心就是把Chrome的客户端证书启动参数和Protractor的配置灵活结合起来，分两步就能搞定：先搞定单用户的无头Chrome+证书配置，再扩展到多用户场景。

Chrome本身支持通过启动参数指定客户端证书，我们只需要在Protractor的配置文件里把这些参数传给ChromeOptions就行。

首先，确保你的证书是PEM格式（如果是PFX/P12格式，后面有转换方法），然后在protractor.conf.js里这么配置：

const path = require('path');

exports.config = {
  directConnect: true, // 直接连接ChromeDriver，跳过Selenium Server，更简洁
  capabilities: {
    browserName: 'chrome',
    chromeOptions: {
      args: [
        '--headless=new', // 用新版无头模式，功能更接近正常Chrome，兼容性更好
        '--disable-gpu', // 旧版无头需要，新版可省略，但加上更稳妥
        // 替换成你的证书绝对路径，用path.resolve避免相对路径坑
        `--client-certificate=${path.resolve(__dirname, './certs/user1-cert.pem')}`,
        // 如果证书有密码，加上这行；没有就删掉
        `--client-certificate-password=${process.env.USER1_CERT_PWD}`
      ]
    }
  },
  // 其他测试配置（specs、framework等）...
};

根据你的测试需求，有两种常见的实现方式：

方式一：串行切换用户测试 #

适合按顺序测试不同用户功能的场景，比如先测用户1的权限，再测用户2的。我们可以通过参数化启动来动态加载不同用户的证书：

1. 先修改配置文件，让它支持读取启动参数：

const path = require('path');

exports.config = {
  directConnect: true,
  capabilities: {
    browserName: 'chrome',
    chromeOptions: {
      args: [
        '--headless=new',
        '--disable-gpu'
        // 证书参数留空，在onPrepare里动态添加
      ]
    }
  },
  onPrepare: function() {
    // 从启动参数里获取当前测试的用户，默认用user1
    const targetUser = browser.params.user || 'user1';
    const certPath = path.resolve(__dirname, `./certs/${targetUser}-cert.pem`);
    // 从环境变量取证书密码，避免硬编码
    const certPassword = process.env[`${targetUser.toUpperCase()}_CERT_PWD`];

    // 动态把证书参数加到Chrome配置里
    browser.driver.getCapabilities().then(caps => {
      const chromeOpts = caps.get('chromeOptions');
      chromeOpts.args.push(`--client-certificate=${certPath}`);
      if (certPassword) {
        chromeOpts.args.push(`--client-certificate-password=${certPassword}`);
      }
    });
  },
  // 其他配置...
};

2. 然后通过不同的命令启动测试：

# 测试用户1
protractor protractor.conf.js --params.user=user1
# 测试用户2
protractor protractor.conf.js --params.user=user2

方式二：并行测试多用户 #

如果想同时跑多个用户的测试来提高效率，可以用multiCapabilities配置，每个用户对应一个独立的Chrome实例：

const path = require('path');

exports.config = {
  directConnect: true,
  multiCapabilities: [
    {
      browserName: 'chrome',
      chromeOptions: {
        args: [
          '--headless=new',
          '--disable-gpu',
          `--client-certificate=${path.resolve(__dirname, './certs/user1-cert.pem')}`,
          `--client-certificate-password=${process.env.USER1_CERT_PWD}`
        ]
      },
      specs: ['./tests/user1-spec.js'] // 指定用户1的测试用例文件
    },
    {
      browserName: 'chrome',
      chromeOptions: {
        args: [
          '--headless=new',
          '--disable-gpu',
          `--client-certificate=${path.resolve(__dirname, './certs/user2-cert.pem')}`,
          `--client-certificate-password=${process.env.USER2_CERT_PWD}`
        ]
      },
      specs: ['./tests/user2-spec.js'] // 指定用户2的测试用例文件
    }
  ],
  maxSessions: 2, // 允许同时运行2个浏览器实例，根据你的机器性能调整
  // 其他配置...
};

启动后，Protractor会同时启动两个无头Chrome实例，分别用不同的证书跑对应的测试。

• 证书格式转换：如果你的证书是PFX/P12格式，用OpenSSL转换成PEM：

  openssl pkcs12 -in user-cert.pfx -out user-cert.pem -nodes
  

• 安全问题：证书密码绝对不要硬编码在配置文件里，用环境变量或者dotenv加载.env文件管理敏感信息。
• 无头模式版本：优先用--headless=new（Chrome 112+），旧版--headless会模拟一个简化版Chrome，可能出现和正常浏览器不一致的测试结果。
• 文件权限：确保ChromeDriver能读取证书文件，Linux/macOS下建议设置权限为chmod 600 user-cert.pem，避免权限过高导致的问题。

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