dawiddutoit/custom-claude/gradle-troubleshooting

# 1. Stop daemon and clean
./gradlew --stop
./gradlew clean
 
# 2. Run with diagnostics
./gradlew build --stacktrace --info
 
# 3. If still failing, generate build scan
./gradlew build --scan
 
# 4. If slow, profile
./gradlew build --profile

# Stack trace (shows where error occurred)
./gradlew build --stacktrace
 
# Full stack trace (complete call stack)
./gradlew build --full-stacktrace
 
# Info logging (what Gradle is doing)
./gradlew build --info
 
# Debug logging (very detailed, generates lots of output)
./gradlew build --debug
 
# Use grep to filter
./gradlew build --info 2>&1 | grep -i error
./gradlew build --info 2>&1 | grep cache

./gradlew build 2>&1 | grep -i "outofmemory\|java heap\|metaspace"

./gradlew dependencies --info 2>&1 | grep -i "could not\|failed\|error"
./gradlew dependencyInsight --dependency spring-core

./gradlew build --no-build-cache --info 2>&1 | grep cache

./gradlew build --no-configuration-cache --info

./gradlew build --stacktrace 2>&1 | grep -A 5 "plugin"

# For this build only
./gradlew build -Dorg.gradle.jvmargs="-Xmx8g"
 
# Or stop daemon and increase persistent memory
./gradlew --stop

# For standard projects (10-30 modules)
org.gradle.jvmargs=-Xmx4g -XX:MaxMetaspaceSize=1g -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8
 
# For large projects (30+ modules)
org.gradle.jvmargs=-Xmx8g -XX:MaxMetaspaceSize=2g -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8
 
# For very large projects
org.gradle.jvmargs=-Xmx12g -XX:MaxMetaspaceSize=3g -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8

./gradlew --stop  # Must restart daemon
./gradlew build --info 2>&1 | grep "XX:Xmx"

# Show full dependency tree
./gradlew dependencies
 
# Show specific configuration
./gradlew dependencies --configuration implementation
 
# Find where a dependency comes from
./gradlew dependencyInsight --dependency spring-core
 
# Show dependency insights for specific config
./gradlew dependencyInsight --dependency jackson-databind --configuration implementation
 
# Refresh and re-download
./gradlew build --refresh-dependencies

// build.gradle.kts
configurations.all {
    resolutionStrategy {
        force("com.google.guava:guava:32.1.3-jre")
    }
}

dependencies {
    implementation("com.example:library:1.0") {
        exclude(group = "commons-logging", module = "commons-logging")
    }
}

dependencies {
    constraints {
        implementation("org.apache.commons:commons-lang3:3.18.0")
    }
}

# Disable cache for this build
./gradlew build --no-build-cache
 
# If this fixes it, cache is the problem
# Clean cache
rm -rf ~/.gradle/caches/build-cache-*
 
# Check cache status
./gradlew build --build-cache --info | grep cache
 
# Verify task is cacheable
./gradlew build --info 2>&1 | grep "Cache key"

# Check for non-cacheable tasks
./gradlew build --info 2>&1 | grep -i "non-cacheable"

# Clean entire cache
rm -rf ~/.gradle/caches
 
# Rebuild
./gradlew build

# Start with warnings (not errors)
./gradlew build --configuration-cache-problems=warn
 
# Check report
# build/reports/configuration-cache/<hash>/configuration-cache-report.html
 
# Once issues fixed, enable strict mode
./gradlew build --configuration-cache-problems=fail

# Disable temporarily
./gradlew build --no-configuration-cache
 
# Check for incompatible plugins
./gradlew build --configuration-cache-problems=warn --info
 
# View detailed report
open build/reports/configuration-cache/report.html

# Update plugins to latest versions
./gradlew wrapper --gradle-version 9.2
./gradlew build -x test  # Skip tests temporarily

# 1. Initial failure
./gradlew build
# BUILD FAILED
 
# 2. Get details
./gradlew build --stacktrace
# Shows: OutOfMemoryError: Java heap space
 
# 3. Fix: Update gradle.properties
echo "org.gradle.jvmargs=-Xmx4g -XX:MaxMetaspaceSize=1g" >> gradle.properties
 
# 4. Stop daemon and retry
./gradlew --stop
./gradlew build
 
# BUILD SUCCESSFUL

# Build fails with version conflict
./gradlew build
# ERROR: Could not resolve dependency: conflicting versions
 
# Investigate
./gradlew dependencyInsight --dependency commons-lang3
 
# You see:
# commons-lang3:3.8.1 <- old-library
# commons-lang3:3.18.0 <- new-library
 
# Solution: Force newer version
# In build.gradle.kts:
configurations.all {
    resolutionStrategy {
        force("org.apache.commons:commons-lang3:3.18.0")
    }
}
 
./gradlew build
# BUILD SUCCESSFUL