构建Google Play应用包时遭遇NullPointerException求助

问题分析 #

从你的描述和代码来看，硬编码签名信息能正常构建，但通过key.properties加载时触发NullPointerException，核心原因是从属性文件加载的值为null时，直接赋值给签名配置属性导致空指针，再结合跨Mac/Windows环境的场景，可能伴随路径解析、文件编码或Git同步的隐性问题。

解决方案 #

1. 给签名配置添加空值校验与明确异常

修改signingConfigs部分代码，对每个加载的属性做非空判断，避免null直接赋值，同时抛出明确的错误提示，方便定位问题：

signingConfigs {
    release {
        keyAlias keystoreProperties['keyAlias'] ?: throw new GradleException("keyAlias 未在 key.properties 中配置")
        keyPassword keystoreProperties['keyPassword'] ?: throw new GradleException("keyPassword 未在 key.properties 中配置")
        storeFile keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : throw new GradleException("storeFile 未在 key.properties 中配置或路径无效")
        storePassword keystoreProperties['storePassword'] ?: throw new GradleException("storePassword 未在 key.properties 中配置")
    }
}

2. 优化key.properties的加载逻辑

替换原有的FileInputStream加载方式，用更安全的withReader，同时校验文件是否存在：

def keystoreProperties = new Properties()
def keystorePropertiesFile = rootProject.file('key.properties')
if (keystorePropertiesFile.exists()) {
    keystorePropertiesFile.withReader('UTF-8') { reader ->
        keystoreProperties.load(reader)
    }
} else {
    throw new GradleException("项目根目录未找到 key.properties 文件")
}

3. 跨环境路径与文件校验

• 路径格式：Windows下使用正斜杠/作为路径分隔符，比如storeFile=../your-key.jks，避免反斜杠的转义问题
• 文件同步：确认jks文件通过Git同步到Windows后路径正确，没有被.gitignore忽略，且文件未损坏
• 编码校验：用Windows记事本打开key.properties，保存为UTF-8编码，避免Mac默认编码导致属性加载失败

4. 提前验证签名配置

执行以下命令提前校验签名配置是否能正常读取，无需等到构建阶段：

# Windows环境
gradlew.bat signingReport

# Mac/Linux环境
./gradlew signingReport

关键注意事项 #

• key.properties的键名是大小写敏感的，确保keyAlias、keyPassword等键名拼写完全一致
• 不要将key.properties和jks文件提交到公开Git仓库，可添加到.gitignore中，通过其他安全方式同步到构建环境

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