TruecallerJS错误处理与调试指南：常见问题排查与解决方案

TruecallerJS错误处理与调试指南：常见问题排查与解决方案

【免费下载链接】truecallerjsTruecallerJS: This is a library for retrieving phone number details using the Truecaller API.项目地址: https://gitcode.com/gh_mirrors/tr/truecallerjs

TruecallerJS是一个用于通过Truecaller API检索电话号码详细信息的库，在使用过程中可能会遇到各种错误。本文将详细介绍TruecallerJS的常见错误类型、排查方法和解决方案，帮助开发者快速定位并解决问题。

一、登录相关错误处理

1.1 "Invalid phone number"错误

当使用login函数时，如果输入的电话号码格式不正确，会抛出"Invalid phone number"错误。这是因为在src/login.ts文件中，代码会使用parsePhoneNumber函数验证电话号码的有效性：

const pn = parsePhoneNumber(phoneNumber); if (!pn?.valid) { throw new Error("Invalid phone number."); }

解决方案：

• 确保输入的电话号码符合国际格式，如+919912345678
• 可以使用parsePhoneNumber函数预先验证号码格式
• 参考官方文档中的示例，正确输入电话号码

1.2 登录验证失败

在登录过程中，可能会遇到多种验证失败的情况，如"Invalid OTP"、"Retries limit exceeded"等。这些错误会在src/cli.ts中被捕获并处理：

if (response1.status === 11) { console.log(chalk.red("! Invalid OTP")); } else if (response1.status === 7) { console.log(chalk.red("Retries limit exceeded")); } else if (response1.suspended) { console.log(chalk.red("Oops... Your account is suspended.")); }

解决方案：

• "Invalid OTP"：确保输入正确的6位验证码
• "Retries limit exceeded"：等待一段时间后再尝试登录
• "Your account is suspended"：联系Truecaller客服解决账号问题

二、号码验证错误处理

2.1 "Phone number should be in international format"错误

在调用verifyOtp函数时，如果电话号码格式不正确，会抛出此错误。在src/verifyOtp.ts中：

const pn = parsePhoneNumber(phonenumber); if (!pn.valid) { throw new Error("Phone number should be in international format."); }

解决方案：

• 确保电话号码包含国家代码，如+1、+44等
• 移除电话号码中的特殊字符和空格
• 使用parsePhoneNumber函数验证号码格式

三、搜索功能错误处理

3.1 "Please login to your account"错误

当尝试使用搜索功能但未登录时，会收到此错误提示。在src/cli.ts中：

if (!fs.existsSync(authKeyFilePath)) { console.error(chalk.magenta.bold("Please login to your account.")); process.exit(); }

解决方案：

• 先执行truecallerjs login命令登录账号
• 检查认证文件是否存在：~/.config/truecallerjs/authkey.json
• 如果认证文件损坏，删除后重新登录

3.2 搜索请求失败

搜索功能可能会因为各种原因失败，错误会在src/cli.ts中被捕获：

catch (error: unknown) { if (error instanceof Error) { console.log(chalk.red(error.message)); } else { console.log(chalk.red("An error occurred.")); } process.exit(1); }

解决方案：

• 检查网络连接是否正常
• 验证installationId是否有效
• 确认API服务是否正常运行

四、调试技巧与最佳实践

4.1 启用详细日志

使用-v或--verbose选项可以获取更多调试信息：

truecallerjs -s +1234567890 -v

4.2 检查认证文件

认证文件存储在~/.config/truecallerjs/authkey.json，可以检查此文件是否存在且格式正确。

4.3 使用原始输出模式

使用-r或--raw选项可以获取原始JSON输出，便于调试：

truecallerjs -s +1234567890 -r

4.4 检查API响应状态

在代码中，可以通过检查API返回的状态码来判断请求是否成功：

if (response1.status === 2 && !response1.suspended) { // 登录成功 }

五、常见问题解答

Q: 为什么我总是收到"Invalid phone number"错误？

A: 请确保电话号码使用国际格式，以"+"开头，包含国家代码，如"+1234567890"。

Q: 如何获取我的installationId？

A: 登录后使用truecallerjs -i命令可以查看installationId。

Q: 我的账号被暂停了，该怎么办？

A: 账号暂停通常是因为违反了Truecaller的使用条款，请联系Truecaller客服解决。

Q: 如何进行批量号码搜索？

A: 使用--bulksearch或--bs选项，如truecallerjs --bs "1234567890,0987654321"。

通过本文介绍的错误处理方法和调试技巧，您应该能够解决使用TruecallerJS过程中遇到的大部分问题。如果遇到其他未涵盖的错误，请参考官方文档或提交issue寻求帮助。

【免费下载链接】truecallerjsTruecallerJS: This is a library for retrieving phone number details using the Truecaller API.项目地址: https://gitcode.com/gh_mirrors/tr/truecallerjs