React Native TypeScript项目调用react-native-fingerprint-scanner函数报错

我之前也碰到过一模一样的问题！在TypeScript项目里使用这个指纹扫描库时，经常会因为模块导入、类型定义或者兼容性问题出现TypeError: FingerprintScanner.isSensorAvailable is not a function的错误，给你几个实用的排查和解决方向：

1. 调整导入方式，匹配TypeScript模块规则 #

JavaScript项目里的导入方式在TS里可能不适用，试试这几种导入方式：

• 命名导入（如果库是导出单个命名对象）：

  import { FingerprintScanner } from 'react-native-fingerprint-scanner';
  

• 整体导入（如果库使用的是默认导出但TS类型定义没正确识别）：

  import * as FingerprintScanner from 'react-native-fingerprint-scanner';
  

很多时候TS对默认导出的解析和JS不一样，换个导入方式就能解决问题。

2. 确保类型定义正确安装 #

这个库的TypeScript类型定义可能需要单独安装，执行以下命令：

npm install @types/react-native-fingerprint-scanner --save-dev
# 或者用yarn
yarn add @types/react-native-fingerprint-scanner --dev

如果安装后还是有问题，可以临时用// @ts-ignore跳过类型检查验证是不是类型定义的问题：

componentDidMount() {
  // @ts-ignore
  FingerprintScanner.isSensorAvailable()
    .catch(error => this.setState({ errorMessage: error.message }));
}

注意这只是临时方案，最好还是让类型定义正常工作。

3. 检查库版本兼容性 #

对比你JavaScript项目和TypeScript项目中react-native-fingerprint-scanner的版本，有些新版本可能修改了API名称（比如把isSensorAvailable改成了isAvailable）。查看你当前安装版本的官方文档，确认API是否有变更。

4. 重新链接原生模块并清理缓存 #

虽然JS项目正常，但TS项目可能因为缓存或者链接异常导致原生模块未正确加载：

1. 重新链接模块：

   npx react-native link react-native-fingerprint-scanner
   

2. 重启Metro服务并清理缓存：

   npx react-native start --reset-cache
   

如果是React Native 0.60+版本，自动链接应该已经生效，但还是可以手动检查iOS的Podfile（是否添加了对应pod）和Android的配置文件（settings.gradle、app/build.gradle是否有库的引用）。

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