wsa-webdav/docs/troubleshooting.md

Troubleshooting

Common issues and solutions for WSA WebDev.

Build Issues

Java not found

Error: JAVA_HOME is not set

Solution:

1. Install JDK 17
2. Set JAVA_HOME environment variable
3. Or let the build script auto-install via winget/choco

Gradle build fails

Error: Could not resolve dependencies

Solution:

1. Delete .build/ directory
2. Run build script again
3. Check internet connection

APK not installing

Error: INSTALL_FAILED_ALREADY_EXISTS

Solution:

adb uninstall com.wsa.webdav
adb install output/app-release.apk

Server Issues

Server won't start

1. Check if port 8088 is in use:

   netstat -ano | findstr 8088
   

2. Kill the process using the port
3. Restart the server

Connection refused

1. Ensure WSA is running
2. Check ADB connection: adb devices
3. Verify server is running:

   adb shell pidof com.wsa.webdav
   

Slow performance

1. Use USB instead of WiFi for ADB
2. Reduce max connections in config.json
3. Close other network-intensive applications

WebDAV Issues

Windows cannot connect

1. Ensure WebClient service is running:

   sc start WebDAV
   

2. Check BasicAuthLevel in registry:

   HKLM\SYSTEM\CurrentControlSet\Services\WebClient\Parameters
   BasicAuthLevel = 2
   

3. Restart WebClient service

Files not showing

1. Check the WebDAV URL path
2. Verify the folder exists in WSA
3. Check server logs

Upload fails

1. Check available storage in WSA
2. Verify file permissions
3. Check max file size limits

Root Access Issues

Permission denied

1. Ensure Magisk is installed
2. Grant root access in Magisk Superuser tab
3. Verify: adb shell su -c whoami returns "root"

SELinux blocking

1. Check SELinux mode: adb shell su -c getenforce
2. Set to permissive (temporarily): adb shell su -c setenforce 0

Logging

View Server Logs

adb shell su -c "cat /data/data/com.wsa.webdav/files/server.log"

View Android Logcat

adb logcat -s WSAWebDAV

Health Check

adb shell am broadcast -a com.wsa.webdav.HEALTH
adb shell cat /sdcard/Android/data/com.wsa.webdav/files/health.json

Getting Help

If your issue isn't covered:

1. Check GitHub Issues
2. Open a new Bug Report
3. Include relevant logs and environment details