通过Cloud Functions调用generatePasswordResetLink生成密码重置链接时，Firebase Auth模拟器提示“missing newPassword query parameter”错误的排查求助

这个问题其实是Firebase Auth模拟器和生产环境的行为差异导致的，别担心，我来帮你理清楚：

首先得明确：Auth模拟器并不会像生产环境那样跳转到一个让用户输入新密码的页面，它的设计是让开发者直接通过HTTP请求完成密码重置操作，所以才会提示你缺少newPassword参数。

你当前的问题点 #

你调用admin.auth().generatePasswordResetLink(user.email, {url: "https://meu.site"})生成的链接，在模拟器环境下，continueUrl并不会被直接跳转——模拟器会拦截这个请求，返回它自己的操作指引，也就是你看到的那个包含urlTemplate的错误响应。

两种解决方式 #

方式一：直接使用模拟器提供的模板URL完成重置

按照模拟器返回的urlTemplate，把NEW_PASSWORD_HERE替换成你想要设置的新密码，然后用浏览器访问这个完整的URL，或者用curl发送GET请求：

curl "http://localhost:9099/emulator/action?mode=resetPassword&lang=en&oobCode=94dZV63_qB1CRcmofnM9bpCD0pLRxqZ4sTVPzwERpMEzWqKKu_9X2d&apiKey=fake-api-key&continueUrl=https%3A%2F%2Fmeu.site%2Fh0qLORGQe4cuoqSoxcA6&newPassword=你的新密码"

这样就能直接完成密码重置了，适合快速测试场景。

方式二：模拟生产环境的密码重置流程（自定义页面）

如果你想更贴近生产环境的体验，需要自己搭建一个密码重置页面，步骤如下：

• 把generatePasswordResetLink的url参数指向你的自定义重置页面，比如https://meu.site/reset-password
• 在这个页面中，通过URL的查询参数获取oobCode（也就是密码重置的验证码）
• 让用户输入新密码，然后调用Firebase客户端SDK的confirmPasswordReset方法完成重置

示例前端代码（假设你用了Firebase Web SDK）：

// 获取URL中的oobCode参数
const urlParams = new URLSearchParams(window.location.search);
const oobCode = urlParams.get('oobCode');

// 当用户提交新密码时调用
async function resetPassword(newPassword) {
  try {
    await firebase.auth().confirmPasswordReset(oobCode, newPassword);
    alert('密码重置成功！');
    // 跳转到首页或登录页
    window.location.href = 'https://meu.site';
  } catch (error) {
    console.error('密码重置失败:', error);
    alert(error.message);
  }
}

这样设置后，用户点击重置链接会跳转到你的自定义页面，输入新密码后完成重置，和生产环境的流程一致。

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