Ionic+Capacitor v5无法追加自定义UserAgent问题求助

1. 移除冲突配置 #

你同时设置了overrideUserAgent和appendUserAgent，这会导致overrideUserAgent直接覆盖原生UserAgent，appendUserAgent的追加逻辑被完全忽略。如果只是要追加自定义字符串，删除所有overrideUserAgent配置项即可。

修改后的配置文件示例：

/// <reference types="@capacitor/push-notifications" />
/// <reference types="@capacitor/splash-screen" />

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
    appId: 'io.icoders.jobinfo',
    appName: 'Jobinfo',
    webDir: 'dist',
    plugins: {
        SplashScreen: {
            launchShowDuration: 5000,
            launchAutoHide: true,
            backgroundColor: '#ffffffff',
            androidSplashResourceName: 'splash',
            androidScaleType: 'CENTER_CROP',
            showSpinner: true,
            androidSpinnerStyle: 'large',
            iosSpinnerStyle: 'small',
            spinnerColor: '#999999',
            splashFullScreen: true,
            splashImmersive: false,
            layoutName: 'launch_screen',
            useDialog: false
        }
    },
    appendUserAgent: 'JobinfoApp',
    android: {
        appendUserAgent: 'JobinfoApp',
    },
    ios: {
        appendUserAgent: 'JobinfoApp',
    }
};

export default config;

2. 重新同步原生项目 #

修改配置后必须执行同步命令，否则配置不会同步到Android/iOS原生项目中：

• Android：运行 npx cap sync android，然后重新构建运行应用
• iOS：运行 npx cap sync ios，打开Xcode重新编译运行

3. Android端兜底方案 #

如果同步后仍不生效，检查Android项目的MainActivity文件（Java或Kotlin），确认没有手动修改WebView UserAgent的代码。若有自定义WebView逻辑，可手动追加字符串：

// MainActivity.java 示例代码
@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    WebView webView = getBridge().getWebView();
    String originalUA = webView.getSettings().getUserAgentString();
    webView.getSettings().setUserAgentString(originalUA + " JobinfoApp");
}

4. iOS端兜底方案 #

iOS端若配置不生效，可直接在Xcode中修改Info.plist：

1. 打开iOS项目的Info.plist文件
2. 添加NSUserAgent键，设置值为 $(PRODUCT_NAME)/$(MARKETING_VERSION) $(original) JobinfoApp
   （$(original)会保留原生UserAgent，后面追加自定义字符串）

验证 #

在应用中通过以下代码打印当前UserAgent确认是否生效：

console.log(navigator.userAgent);

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