无法打开Fragment：‘找不到Fragment构造函数’问题解决求助

问题背景 #

我有一个MoneyListFragment，原本在HomeFragment的ViewPager中通过构造函数传参加载。现在想从MainActivity通过Navigation组件打开它，已经在nav_graph_main.xml中配置了Fragment和参数，但启动时抛出Could not find Fragment constructor错误。

错误原因 #

Navigation组件（以及Android系统本身）要求Fragment必须具备无参构造函数——系统在重建Fragment（比如屏幕旋转、内存回收后恢复）时会通过无参构造实例化Fragment。当前MoneyListFragment只有带参数的构造函数，导致系统无法实例化，触发报错。另外代码中同时混用了构造函数传参和Arguments传参，逻辑冗余且容易出问题。

解决方案 #

1. 给Fragment添加无参构造函数，并统一用Arguments传递参数 #

修改MoneyListFragment，移除构造函数中的参数，改用无参构造，同时通过Arguments（推荐用Navigation Safe Args）获取参数。如果需要保留ViewPager中的构造传参方式，可以添加静态工厂方法，内部统一将参数存入Arguments。

2. 优化参数解析逻辑 #

利用Navigation Safe Args自动生成的类解析参数，避免手动判断字符串的冗余代码，同时保证类型安全。

修改后的代码示例 #

MoneyListFragment.kt

class MoneyListFragment : BaseFragment<FragmentMoneyListBinding>() {

    // 用Safe Args自动生成的类获取参数
    private val args: MoneyListFragmentArgs by navArgs()

    override val bindingInflater: (LayoutInflater) -> ViewBinding
        get() = FragmentMoneyListBinding::inflate

    // 给ViewPager使用的静态工厂方法，统一存入Arguments
    companion object {
        fun newInstance(detailList: List<MoneyItem>?, moneyType: MoneyType): MoneyListFragment {
            return MoneyListFragment().apply {
                arguments = MoneyListFragmentArgs.Builder()
                    .setDetailList(detailList?.toTypedArray())
                    .setMoneyType(moneyType)
                    .build().toBundle()
            }
        }
    }

    override fun onCreateFinished() {
        val detailList = args.detailList?.toList()
        val moneyType = args.moneyType

        if (detailList.isNullOrEmpty()) {
            binding.groupNoDetail.visible()
        } else {
            binding.rvMoneyDetail.visible()
            binding.rvMoneyDetail.adapter = MoneyDetailAdapter(detailList, moneyType)
        }
    }
}

注意事项

• 确保MoneyItem和MoneyType实现了Parcelable接口（Navigation传递自定义类型参数必须支持Parcelable/Serializable）。
• 重新编译项目，让Safe Args自动生成MoneyListFragmentArgs类。

修改ViewPager中的加载方式

原来用构造函数传参的地方，改用静态工厂方法：

// ViewPager适配器中创建Fragment的代码
MoneyListFragment.newInstance(detailList, moneyType)

MainActivity.kt（无需修改，保持原有调用即可）

if (earningList == null){
    val emptyList = listOf(MoneyItem("null", "null", "null"))
    Navigation.findNavController(this, R.id.nav_host_fragment).navigate(
        HomeFragmentDirections.actionHomeToMoneyListFragment(emptyList.toTypedArray(), MoneyType.SPENDING)
    )
} else {
    earningList?.let { it1 ->
        Navigation.findNavController(this, R.id.nav_host_fragment).navigate(
            HomeFragmentDirections.actionHomeToMoneyListFragment(it1.toTypedArray(), MoneyType.SPENDING)
        )
    }
}

关键说明 #

• 永远不要给Fragment添加带参数的构造函数作为唯一构造，必须保留无参构造（可以是显式或隐式的）。
• 统一用Arguments传递参数，不管是ViewPager加载还是Navigation跳转，既能满足系统重建要求，也能保证参数传递的一致性。

内容的提问来源于stack exchange，提问作者Ahmet Yılmaz