如何使用PyO3从Rust返回第三方Python模块对象（如fractions.Fraction）

API 探路者

2026-7-23

解决PyO3返回Python fractions.Fraction对象的类型匹配问题

问题分析

你遇到的类型不匹配错误，核心原因是Result嵌套和错误处理不当：

frac.call_method本身返回PyResult<&PyAny>，你外层又包裹了Ok()，导致最终返回值变成Result<Result<&PyAny, PyErr>, _>，和声明的PyResult<PyAny>类型不兼容。
使用ok().unwrap()会在模块导入失败时直接panic，不符合PyO3的错误处理规范，应该用?传递错误。
离开GIL作用域后，&PyAny这类引用会失效，需要返回拥有所有权的Py<PyAny>类型。

修正后的代码

以下是能正确返回Python fractions.Fraction对象的实现：

use pyo3::prelude::*;

#[pyfunction]
pub fn divide(numer: isize, denom: isize) -> PyResult<Py<PyAny>> {
    Python::with_gil(|py| {
        // 导入fractions模块，用?处理导入错误
        let fractions = py.import("fractions")?;
        // 获取Fraction类
        let fraction_class = fractions.getattr("Fraction")?;
        // 调用Fraction构造函数，传入分子分母
        let fraction = fraction_class.call((numer, denom), None)?;
        // 将引用转换为拥有所有权的Py<PyAny>，确保离开GIL后有效
        Ok(fraction.into())
    })
}

// 注册模块（如果需要导出到Python）
#[pymodule]
fn my_rust_module(_py: Python<'_>, m: &PyModule) -> PyResult<()> {
    m.add_function(wrap_pyfunction!(divide, m)?)?;
    Ok(())
}

关键修正点

用?替代unwrap()：所有可能出错的操作（导入模块、获取属性、调用方法）都用?传递错误，符合PyO3的错误处理逻辑，错误会自动转换为Python可识别的异常。
转换为Py<PyAny>：通过into()方法将&PyAny转换为拥有所有权的Py<PyAny>，保证离开GIL作用域后对象依然有效。
直接调用Fraction类：通过getattr获取Fraction类后调用，比call_method更直观，也避免了方法调用的歧义。