如何避免LocationManager未获取位置时提交Complaint出现空值？

你遇到的问题本质是异步操作的时序问题——位置获取通过LocationListener回调完成，用户点击提交按钮的动作可能早于回调触发，导致存储位置的全局变量还未赋值。下面是几个切实可行的解决办法：

方案1：控制按钮可用性，避免提前点击 #

核心思路：Fragment初始化时先禁用提交按钮，等位置成功获取（或超时）后再启用，同时给用户明确的状态提示，从根源上避免提前点击。

代码修改： #

1. 初始化按钮状态（在onViewCreated中）：

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    // 初始禁用按钮，显示加载状态
    btn_make_complaint.isEnabled = false
    btn_make_complaint.text = "正在获取位置..."
    
    // 启动位置获取流程
    requestLocationPermission()
    
    btn_make_complaint.setOnClickListener {
        // 原提交逻辑保持不变
        val givenAddress = et_complaint_location.text.toString()
        val complaintContent = et_complaint.text.toString()
        val complaintLocation: String? = addressString
        val complaint = Complaint(
            userName = GlobalValues.userName.value.toString(),
            content = complaintContent,
            location = complaintLocation ?: givenAddress,
            status = "Solving",
            urgency = "Not urgent",
            latitude = latLongMap["latitude"],
            longitude = latLongMap["longitude"],
        )
        viewModel.saveImageToStorage(selectedPicture!!, complaint)
    }
}

2. 位置获取回调中更新按钮状态：

override fun onLocationChanged(location: Location) {
    val geocoder = Geocoder(requireContext(), Locale.getDefault())
    try {
        val addresses = geocoder.getFromLocation(location.latitude, location.longitude, 1)
        if (!addresses.isNullOrEmpty()) {
            val address = addresses[0]
            addressString = address.locality
            latLongMap = hashMapOf(
                "latitude" to address.latitude,
                "longitude" to address.longitude
            )
            // 位置获取成功，恢复按钮正常状态
            btn_make_complaint.isEnabled = true
            btn_make_complaint.text = "提交投诉"
            println(addressString)
        } else {
            // 未解析到地址，允许用户手动输入
            btn_make_complaint.isEnabled = true
            btn_make_complaint.text = "提交投诉"
            Toast.makeText(requireContext(), "无法获取当前位置，请手动输入", Toast.LENGTH_SHORT).show()
        }
    } catch (e: IOException) {
        e.printStackTrace()
        btn_make_complaint.isEnabled = true
        btn_make_complaint.text = "提交投诉"
        Toast.makeText(requireContext(), "位置解析失败，请手动输入", Toast.LENGTH_SHORT).show()
    }
}

3. 添加超时机制：
   在requestLocationPermission的权限通过分支里，添加5秒超时任务，避免用户一直等待：

private lateinit var locationTimeoutHandler: Handler

// 权限通过后添加：
locationTimeoutHandler = Handler(Looper.getMainLooper())
locationTimeoutHandler.postDelayed({
    if (!btn_make_complaint.isEnabled) {
        btn_make_complaint.isEnabled = true
        btn_make_complaint.text = "提交投诉"
        Toast.makeText(requireContext(), "位置获取超时，请手动输入", Toast.LENGTH_SHORT).show()
    }
}, 5000) // 5秒超时

同时在Fragment销毁时清理超时任务，避免内存泄漏：

override fun onDestroyView() {
    super.onDestroyView()
    if (::locationTimeoutHandler.isInitialized) {
        locationTimeoutHandler.removeCallbacksAndMessages(null)
    }
}

方案2：点击按钮时等待位置回调（如果未完成） #

核心思路：如果用户点击时位置还未获取，显示加载弹窗等待回调完成；若已获取则直接提交，兼顾灵活性和用户体验。

代码修改： #

1. 新增状态标记变量：

private var isLocationReady = false

2. 更新位置回调的状态标记：

override fun onLocationChanged(location: Location) {
    // ... 原位置解析逻辑 ...
    isLocationReady = true // 标记位置已就绪
}

3. 修改按钮点击事件：

btn_make_complaint.setOnClickListener {
    val givenAddress = et_complaint_location.text.toString()
    val complaintContent = et_complaint.text.toString()
    
    // 先校验投诉内容是否为空
    if (complaintContent.isEmpty()) {
        Toast.makeText(requireContext(), "请输入投诉内容", Toast.LENGTH_SHORT).show()
        return@setOnClickListener
    }
    
    if (isLocationReady) {
        // 位置已就绪，直接提交
        val complaintLocation: String? = addressString
        val complaint = Complaint(
            userName = GlobalValues.userName.value.toString(),
            content = complaintContent,
            location = complaintLocation ?: givenAddress,
            status = "Solving",
            urgency = "Not urgent",
            latitude = latLongMap["latitude"],
            longitude = latLongMap["longitude"],
        )
        viewModel.saveImageToStorage(selectedPicture!!, complaint)
    } else {
        // 位置未就绪，显示加载弹窗
        val loadingDialog = AlertDialog.Builder(requireContext())
            .setMessage("正在获取位置，请稍候...")
            .setCancelable(false)
            .create()
        loadingDialog.show()
        
        // 设置5秒超时，避免无限等待
        Handler(Looper.getMainLooper()).postDelayed({
            if (!isLocationReady) {
                loadingDialog.dismiss()
                Toast.makeText(requireContext(), "位置获取超时，请手动输入后重试", Toast.LENGTH_SHORT).show()
            }
        }, 5000)
        
        // 监听位置就绪事件，完成后提交
        val observer = Observer<Pair<String, HashMap<String, Double>>> {
            loadingDialog.dismiss()
            val (addressStr, latLongMap) = it
            val complaint = Complaint(
                userName = GlobalValues.userName.value.toString(),
                content = complaintContent,
                location = addressStr ?: givenAddress,
                status = "Solving",
                urgency = "Not urgent",
                latitude = latLongMap["latitude"],
                longitude = latLongMap["longitude"],
            )
            viewModel.saveImageToStorage(selectedPicture!!, complaint)
            // 移除观察者避免重复触发
            locationData.removeObserver(observer)
        }
        locationData.observe(viewLifecycleOwner, observer)
    }
}

方案3：用LiveData替代全局变量（符合Jetpack架构） #

核心思路：将位置数据包装为LiveData，Fragment观察数据变化，避免全局变量的不可控性，同时自动感知数据更新。

代码修改： #

1. 定义位置数据LiveData：

private val locationData = MutableLiveData<Pair<String, HashMap<String, Double>>>()

2. 位置回调中更新LiveData：

override fun onLocationChanged(location: Location) {
    val geocoder = Geocoder(requireContext(), Locale.getDefault())
    try {
        val addresses = geocoder.getFromLocation(location.latitude, location.longitude, 1)
        if (!addresses.isNullOrEmpty()) {
            val address = addresses[0]
            val addressStr = address.locality
            val latLongMap = hashMapOf(
                "latitude" to address.latitude,
                "longitude" to address.longitude
            )
            locationData.postValue(Pair(addressStr, latLongMap))
        } else {
            locationData.postValue(null) // 标记获取失败
        }
    } catch (e: IOException) {
        e.printStackTrace()
        locationData.postValue(null)
    }
}

3. 观察LiveData并处理提交：

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    
    btn_make_complaint.setOnClickListener {
        val givenAddress = et_complaint_location.text.toString()
        val complaintContent = et_complaint.text.toString()
        
        if (complaintContent.isEmpty()) {
            Toast.makeText(requireContext(), "请输入投诉内容", Toast.LENGTH_SHORT).show()
            return@setOnClickListener
        }
        
        // 获取当前位置数据
        val locationPair = locationData.value
        if (locationPair != null) {
            val (addressStr, latLongMap) = locationPair
            val complaint = Complaint(
                userName = GlobalValues.userName.value.toString(),
                content = complaintContent,
                location = addressStr ?: givenAddress,
                status = "Solving",
                urgency = "Not urgent",
                latitude = latLongMap["latitude"],
                longitude = latLongMap["longitude"],
            )
            viewModel.saveImageToStorage(selectedPicture!!, complaint)
        } else {
            // 位置未获取，使用用户输入的地址
            val complaint = Complaint(
                userName = GlobalValues.userName.value.toString(),
                content = complaintContent,
                location = givenAddress,
                status = "Solving",
                urgency = "Not urgent",
                latitude = null,
                longitude = null,
            )
            viewModel.saveImageToStorage(selectedPicture!!, complaint)
            Toast.makeText(requireContext(), "无法获取当前位置，已使用您输入的地址", Toast.LENGTH_SHORT).show()
        }
    }
    
    // 启动位置获取
    requestLocationPermission()
}

额外注意事项 #

1. Geocoder异常处理：getFromLocation可能抛出IOException，必须捕获处理，避免崩溃。
2. 地址列表空判断：不能直接取addresses[0]，需先判断列表是否为空，否则会触发索引越界异常。
3. 权限申请回调：在权限申请成功后，需重新调用requestLocationPermission触发位置获取：

private val locationPermissionRequest = registerForActivityResult(
    ActivityResultContracts.RequestMultiplePermissions()
) { permissions ->
    if (permissions.all { it.value }) {
        requestLocationPermission()
    } else {
        Toast.makeText(requireContext(), "需要位置权限来自动获取地址", Toast.LENGTH_SHORT).show()
        btn_make_complaint.isEnabled = true
    }
}

内容的提问来源于stack exchange，提问作者Sevban Bayır